Google Docs
Read, edit, comment on, and search Google Docs from Phyllax. Powered by @a-bonus/google-docs-mcp.
Quick Setup
Google Docs uses the same OAuth flow as Gmail and Google Calendar. If you've already connected one of those, Docs uses the same credentials.
- In Phyllax → Integrations → Google Docs → click Connect
- Browser opens → sign in to your Google account → grant the requested scopes
- Done
If you haven't connected any Google integration yet, see Gmail's setup for the one-time Google OAuth credentials walkthrough — the same credentials work for Docs.
Required Credentials
Same as other Google integrations — Client ID + Client Secret from Google Cloud Console. See Gmail setup for the detailed walkthrough.
OAuth Scopes
| Scope | Purpose |
|---|---|
https://www.googleapis.com/auth/documents | Full read/write on Google Docs content |
https://www.googleapis.com/auth/drive.readonly | List and search all your Drive files (so the AI can find Docs by name/content) |
https://www.googleapis.com/auth/drive.file | Create new Docs (scoped — Phyllax can only touch files it created) |
What Phyllax Can Do
The MCP server exposes 33 tools spanning these categories:
| Category | Examples |
|---|---|
| Find docs | listDocuments, searchDocuments, getDocumentInfo, listFolderContents |
| Read | readDocument (text, markdown, or raw JSON), listTabs |
| Create | createDocument, createDocumentFromTemplate |
| Edit content | appendText, insertText, deleteRange, modifyText, findAndReplace |
| Markdown helpers | appendMarkdown, replaceDocumentWithMarkdown, replaceRangeWithMarkdown — preferred for drafting long content |
| Structure | insertTable, insertTableWithData, insertPageBreak, insertSectionBreak, insertImage |
| Formatting | applyTextStyle (bold, italic, color, font, links), applyParagraphStyle (alignment, spacing) |
| Comments | listComments, getComment, addComment, replyToComment, resolveComment, deleteComment |
What Phyllax Monitors
| Schedule | What it checks |
|---|---|
| Recent documents | New or recently edited Docs in your Drive |
| Pending comments | Comments on Docs you own that need a response |
| Mentioned in a doc | Someone @mentioned you in a Doc |
| Doc shared with me | New Doc someone shared with you |
Notification Actions
- Open in Docs — opens the Doc at
https://docs.google.com/document/d/<id> - Reply to comment — AI drafts a reply; you edit and post
- Resolve comment — mark the comment thread resolved
- Summarize — AI generates a brief of the doc
Troubleshooting
"Scopes not authorized"
You skipped one of the required scopes during OAuth. Disconnect, reconnect, and approve all scopes when prompted.
Sheets / Calendar / general Drive tools are missing
The @a-bonus/google-docs-mcp package ships with extra tools (Sheets, Gmail, Calendar, general Drive). Phyllax filters those out because we have dedicated MCPs for each. That's intentional — you get Docs functionality cleanly here, and Sheets/Calendar via their own integrations.
"Insufficient permission" when editing
Make sure you have edit access to the Doc in question. The MCP can only edit Docs the authenticated user can write to.