Composio · Google Docs

Toolkit slug: googledocs. Read the [[composio]] hub first for the call model. A document is identified by its document_id (the id in the Docs URL).

agent-swarm x composio POST /tools/execute/<SLUG> \
  --body '{"user_id":"<connected-account-email>","connected_account_id":"<active-connected-account-id>","arguments":{ … }}'

Follow the hub's Resolve the user and connected account procedure, then select the resolved user's googledocs account whose status is ACTIVE.

Headline tools

Slug	What	Key args
`GOOGLEDOCS_SEARCH_DOCUMENTS`	Find docs (Drive search)	`query`, `max_results` (def 10), `order_by` (def `modifiedTime desc`), `modified_after`, `created_after`, `starred_only`, `shared_with_me`, `response_detail` (def `minimal`)
`GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT`	Read doc as text	`document_id`, `include_tables` (def true), `include_headers`, `include_footers`, `include_footnotes`, `include_tabs_content`
`GOOGLEDOCS_GET_DOCUMENT_BY_ID`	Full structured doc JSON	`document_id`
`GOOGLEDOCS_CREATE_DOCUMENT`	Create blank/with text	`title`, `text`
`GOOGLEDOCS_CREATE_DOCUMENT_MARKDOWN`	Create from markdown	`title`, `markdown_text`, `image_assets`
`GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN`	Replace body with markdown	`document_id`, `markdown_text`
`GOOGLEDOCS_INSERT_TEXT_ACTION`	Insert text at index	`document_id`, `text`, `index`
`GOOGLEDOCS_REPLACE_ALL_TEXT`	Find & replace	`document_id`, `find`, `replace`
`GOOGLEDOCS_COPY_DOCUMENT`	Duplicate a doc	`document_id`, `title`
`GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF`	Export to PDF	`document_id`

Full set: 35 tools — agent-swarm x composio GET "/tools?toolkit_slug=googledocs&limit=100" | jq -r '.items[]|"\(.slug)\t\(.name)"'. Prefer the *_MARKDOWN create/update tools for authoring; the granular INSERT_*/DELETE_*/table tools are for surgical structural edits.

Search recipe

agent-swarm x composio POST /tools/execute/GOOGLEDOCS_SEARCH_DOCUMENTS \
  --body '{"connected_account_id":"ca_…","arguments":{"query":"workshop","max_results":5}}'
# → results under .data.files[]  (id, name, modifiedTime …)

Results are Drive file entries at .data.files[] — grab .id to read.
order_by defaults to modifiedTime desc (most recent first).
Use modified_after / shared_with_me to narrow.

Read recipe

agent-swarm x composio POST /tools/execute/GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT \
  --body '{"connected_account_id":"ca_…","arguments":{"document_id":"<id>","include_tables":true}}'

Use GET_DOCUMENT_PLAINTEXT for reading content; only reach for GET_DOCUMENT_BY_ID when you need the structured JSON (styles, indices) for an edit.

Create-from-markdown recipe

agent-swarm x composio POST /tools/execute/GOOGLEDOCS_CREATE_DOCUMENT_MARKDOWN \
  --body '{"connected_account_id":"ca_…","arguments":{
    "title":"Weekly updates","markdown_text":"# Heading\n\n- point one\n- point two"
  }}'

Google Doc to agent-fs

Read the source with GOOGLEDOCS_GET_DOCUMENT_PLAINTEXT and retain its returned title and display URL as provenance.
Write the converted content to your own agent-fs namespace with a short provenance header naming the source document and import method.
Resolve the destination org and drive from the environment or agent-fs stat <path> --json; the artifacts skill documents the canonical storage and share-link workflow. Never copy org or drive IDs from an example.
Read the stored file back and assert several markers: the title, a middle phrase, and the final sentence. A successful byte-count response alone does not prove fidelity.

Plaintext is intentionally lossy. Inline images may become bare [IMAGE] markers, and headings may be flattened into adjacent paragraphs. If those features matter, use GOOGLEDOCS_GET_DOCUMENT_BY_ID for structured JSON or a Google Drive export, then preserve or reconstruct the structure explicitly. There is no GET_DOCUMENT_MARKDOWN tool; markdown exists on create/update, not on read.

Gotchas

Search returns Drive metadata, not document content — do a second GET_DOCUMENT_PLAINTEXT call with the .id to read.
Doc bodies can be long/token-heavy and may contain secrets — read only what you need (include_headers/footers/footnotes default off for a reason).
Create/update/replace are write actions — only on explicit request.

Composio Google Docs