Google Docs ACTION

Create Tab

Add a new tab to an existing Google Doc and return its Tab ID. The tab is created empty; pass the returned tabId as Tab ID to Insert Text, Write Table, Insert Image, Insert Table or Insert Page Break to fill it, because an edit sent without a Tab ID always goes to the document's first tab. Added at the end of the document's tabs unless Position is set, and nested under another tab when Parent Tab ID is set. Use List Tabs to see the tabs a document already has, or Find Document to resolve a document's name to its ID. Position applies only to the tab being created: this tool set cannot rename, reorder or delete a tab that already exists — say so plainly rather than attempting a workaround such as recreating the tab. See the documentation

Action
Writes data
OAuth
SDK
MCP

Start building

IMPLEMENTATION

Call this tool

Connect a user's Google Docs account once, then configure and run Create Tab from your backend or agent.

Pipedream Connect

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "google_docs-create-tab",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    google_docs: { authProvisionId: "apn_xxxxxxx" },
    documentId: "Document ID",
    title: "Title",
  },
})

console.log(result)

curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "google_docs-create-tab",
    "configured_props": {
      "google_docs": { "authProvisionId": "apn_xxxxxxx" },
      "documentId": "Document ID",
      "title": "Title"
    }
  }'

// accessToken: mint a short-lived token with the Connect SDK — see the MCP guide
const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": "{project_id}",
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "google_docs",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "google_docs-create-tab",
  arguments: {
    documentId: "Document ID",
    title: "Title",
  },
})

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Create Tab inputs
Property	Type	Description
`documentId` Document ID	`string`	The ID of the Google Doc. This is the long string in the document's URL: `https://docs.google.com/document/d/{DOCUMENT_ID}/edit`. Use Find Document to resolve a document's name to its ID. Required
`title` Title	`string`	The name of the new tab, as it will appear in the document's tab list (e.g. `Q3 Budget`). Required
`index` Position	`integer`	Optional zero-based position for the new tab among its siblings — `0` makes it the document's first tab. Every tab at or after this position shifts down by one. Omit to add the tab after the existing ones. Optional
`parentTabId` Parent Tab ID	`string`	Optional. To nest the new tab as a sub-tab, the ID of the tab to nest it under (e.g. `t.0`), from List Tabs. Omit for a top-level tab. Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key: google_docs-create-tab
Version: 0.0.1
App: Google Docs
Authentication: OAuth
Read-only: No
Destructive: No
Open world: Yes
Source: View on GitHub ↗

Call this tool #

Inputs #

Tool details #

Call this tool

Inputs

Tool details