Atlas / MCP servers / a-bonus / Google Docs

Google DocsCAUTION

Name: Google Docs
Author: a-bonus

mcp/a-bonus/google-docs

MCP server by a-bonus · Audited 2026-09-28

The Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.

Verdict

CAUTION

Grade

Trust score

89 /100

Exposed tools

121 112r · 7w · 2d

Transport

streamable-http

License

MIT

Stars

664

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

[](https://mcptoplist.com/server/glama%2Fa-bonus%2Fgoogle-docs-mcp)

Connect Claude Desktop, Cursor, or any MCP client to your Google Docs, Google Sheets, Google Drive, Gmail, and Google Calendar.

Quick Start

1. Create a Google Cloud OAuth Client

Go to the Google Cloud Console
Create or select a project
Enable the Google Docs API, Google Sheets API, Google Drive API, Gmail API, and Google Calendar API
Configure the OAuth consent screen (External, add your email as a test user, and add the gmail.modify and calendar.events scopes alongside the Docs/Sheets/Drive scopes)
Create an OAuth client ID (Desktop app type)
Copy the Client ID and Client Secret from the confirmation screen

Need more detail? See step-by-step instructions at the bottom of this page.

2. Authorize

GOOGLE_CLIENT_ID="your-client-id" \
GOOGLE_CLIENT_SECRET="your-client-secret" \
npx -y @a-bonus/google-docs-mcp auth

This opens your browser for Google authorization. After you approve, the refresh token is saved to ~/.config/google-docs-mcp/token.json.

3. Add to Your MCP Client

Claude Desktop / Cursor / Windsurf:

{
"mcpServers": {
"google-docs": {
"command": "npx",
"args": ["-y", "@a-bonus/google-docs-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id",
"GOOGLE_CLIENT_SECRET": "your-client-secret"
}
}
}
}

The server starts automatically when your MCP client needs it.

Remote Deployment (Cloud Run)

Deploy once for your team -- no local installs required. The server uses MCP OAuth 2.1 so your MCP client handles authentication automatically.

gcloud run deploy google-docs-

Read from source at commit bab48508c25bOBSERVED · 2026-09-28

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.

claude-code

claude mcp add google-docs-mcp --env GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET} --env JWT_SIGNING_KEY=${JWT_SIGNING_KEY} --env TOKEN_ENCRYPTION_KEY=${TOKEN_ENCRYPTION_KEY} --env TOKEN_STORE=${TOKEN_STORE} -- npx -y @a-bonus/[email protected]

claude-desktop

{
  "mcpServers": {
    "google-docs-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@a-bonus/[email protected]"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "${GOOGLE_CLIENT_SECRET}",
        "JWT_SIGNING_KEY": "${JWT_SIGNING_KEY}",
        "TOKEN_ENCRYPTION_KEY": "${TOKEN_ENCRYPTION_KEY}",
        "TOKEN_STORE": "${TOKEN_STORE}"
      }
    }
  }
}

Exposed tools (121)

112 read · 7 write · 2 destructive. Blast radius: 2 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

Tool	Risk	Description
`addComment`	read	Adds a comment to the document at the specified text range. Use listComments to retrieve the comment ID after creation. Note: programmatically created comments appear in the comments panel but may not show as anchored highlights in the document UI.
`addConditionalFormatting`	read	Adds a conditional formatting rule to one or more ranges in a spreadsheet. Applies a format (background color, bold, text color, etc.) when cells meet a specified condition. Use CUSTOM_FORMULA for complex conditions like
`addSheet`	read	Adds a new sheet (tab) to an existing spreadsheet. Returns the new sheet
`addTab`	write	Adds a new tab to a Google Docs document. Optionally set the tab title, position, parent tab (for nesting), and icon emoji. Returns the new tab
`appendMarkdown`	read	Appends formatted content to the end of a document using markdown syntax. Supports headings, bold, italic, strikethrough, links, and bullet/numbered lists. Use this instead of appendText when you need formatting.
`appendRows`	read	Appends rows to the end of a sheet. Data is added after the last row with content in the specified range.
`appendTableRows`	read	Appends one or more plain-text rows to the end of an existing Google Docs table while preserving the table structure.
`appendText`	read	Appends plain text to the end of a document. For formatted content, use appendMarkdown instead.
`applyParagraphStyle`	read	Applies paragraph-level formatting (alignment, spacing, heading styles) to paragraphs identified by a character range or by searching for text. Use namedStyleType to set heading levels (HEADING_1 through HEADING_6).
`applyTextStyle`	read	Applies character-level formatting (bold, italic, color, font, etc.) to text identified by a character range or by searching for a text string. This is the primary tool for styling text in a document.
`autoResizeColumns`	read	Auto-resizes columns in a spreadsheet to fit their content. Optionally restrict to a column range (e.g.,
`autoResizeRows`	read	Auto-resizes rows in a spreadsheet to fit their content. Optionally restrict to a row range (e.g., startRow=2, endRow=50); defaults to all rows.
`batchApplyTextStyle`	read	Applies character-level formatting (bold, italic, color, font, etc.) to MANY ranges in a single tool
`batchWrite`	read	Writes data to multiple ranges in a single API call. More efficient than multiple separate writeSpreadsheet calls when updating several ranges at once.
`clearRange`	read	Clears all cell values in a range without deleting the cells themselves. Formatting is preserved.
`cloneTable`	read	Clones a source Google Docs table into a target document, preserving text, column widths, row styles, cell styles, and pinned header rows where supported.
`copyFile`	read	Creates a copy of a file or document in Google Drive. Returns the new copy
`copyFormatting`	read	Copies formatting (not values) from a source range to a destination range within the same spreadsheet. Copies bold, colors, borders, number formats, etc.
`copySheetTo`	read	Copies a sheet (tab) from one spreadsheet to another spreadsheet. Use getSpreadsheetInfo to find the numeric sheet ID. The copied sheet will be appended to the destination spreadsheet.
`createAppsScriptProject`	read	Creates an Apps Script project, optionally bound to a Doc, Sheet, Slides or Form so its triggers and custom menus run inside that file. Optionally writes the initial files in the same call. Requires the Apps Script API to be enabled at https://script.google.com/home/usersettings.
`createDocument`	read	Creates a new empty Google Document. Optionally places it in a specific folder and adds initial text content.
`createDocumentFromTemplate`	read	Creates a new document by copying an existing template and optionally replacing placeholder text. Provide key-value pairs in the replacements parameter to substitute template variables.
`createDraft`	write	Creates a Gmail draft (does NOT send). Use this for AI-composed emails that the user should review before sending. The draft appears in the Gmail Drafts folder and can be sent later with sendDraft, edited with updateDraft, or deleted with deleteDraft. Supports threading via replyToMessageId.
`createEvent`	write	Creates a new event on a Google Calendar. Supports timed events (start/end with dateTime) and all-day events (start/end with date). Set sendUpdates to email invitations to attendees.
`createFolder`	read	Creates a new folder in Google Drive. Optionally places it inside an existing parent folder.
`createSheetsCellNote`	read	Creates or replaces a native Google Sheets cell note on a cell or range. Use this when the review text must be attached to a specific cell in the Sheets UI. This is a cell note, not a threaded Drive comment.
`createSpreadsheet`	read	Creates a new spreadsheet. Optionally places it in a specific folder and populates it with initial data.
`createTable`	read	Creates a new named table with specific column types. Tables provide structured data with typed columns, automatic formatting, and special features like dropdown validation.
`deleteChart`	read	Deletes a chart from a Google Spreadsheet by chart ID.
`deleteComment`	read	Permanently deletes a comment and all its replies from the document.
`deleteConditionalFormatting`	read	Deletes one or more conditional formatting rules from a sheet by their index. Use getConditionalFormatting to list existing rules and their indices.
`deleteDraft`	read	Permanently deletes a Gmail draft. This is irreversible — the draft is removed entirely, not moved to Trash. Use when an AI-composed draft was rejected or replaced.
`deleteEvent`	destructive	Deletes an event from a Google Calendar. This is permanent — the event is removed, not trashed. Use sendUpdates to email cancellations to attendees.
`deleteFile`	write	Moves a file or folder to the trash, or permanently deletes it. Set permanent=true for irreversible deletion.
`deleteRange`	read	Deletes content within a character range [startIndex, endIndex) from a document. Use readDocument with format=
`deleteSheet`	read	Deletes a sheet (tab) from a spreadsheet. Use getSpreadsheetInfo to find the numeric sheet ID.
`deleteSheetsComment`	read	Permanently deletes a comment and all its replies from a Google Spreadsheet.
`deleteTable`	read	Deletes a table from a spreadsheet. By default, only removes the table object and formatting while keeping the cell data. Optionally clears the data as well.
`deleteTableRows`	read	Deletes one or more rows from an existing Google Docs table without replacing the whole document.
`downloadFile`	read	Downloads any file from Google Drive to a local path.
`duplicateSheet`	read	Duplicates a sheet (tab) within a spreadsheet, copying all values, formulas, formatting, validations, and conditional formatting. Use getSpreadsheetInfo to find the numeric sheet ID.
`findAndReplace`	read	Replaces all occurrences of a text string throughout the document (or a specific tab).
`findElement`	read	Locates elements in a Google Document. With textQuery, returns the document index range (startIndex/endIndex) of every non-overlapping occurrence of the text — use each as a range for deleteRange or the text-styling tools, or its startIndex as an insertText location. With elementType
`findSectionsByHeading`	read	Finds heading-based sections in a Google Document and reports heading ranges plus the first table that follows each heading.
`formatCells`	read	Applies formatting to a range of cells in a spreadsheet. Supports bold, italic, font size, text color, background color, alignment, and number format. Use range
`freezeRowsAndColumns`	read	Pins rows and/or columns so they stay visible when scrolling. Use frozenRows=1 to freeze a header row. Set a value to 0 to unfreeze.
`getAppsScriptContent`	read	Reads the files of an Apps Script project. Use it before updateAppsScriptContent to see what is already there, or to review code that is currently deployed.
`getComment`	read	Gets a specific comment and its full reply thread. Use listComments first to find the comment ID.
`getConditionalFormatting`	read	Lists all conditional formatting rules for a sheet as JSON. Each rule includes its index (needed for deleteConditionalFormatting), kind (BOOLEAN or GRADIENT), ranges, condition type/values, and applied formats (colors, bold, italic).
`getDocumentInfo`	read	Gets metadata about a document including its name, owner, sharing status, and modification history.
`getDraft`	read	Fetches a single Gmail draft by ID with full headers and body. Use listDrafts to discover draft IDs.
`getFolderInfo`	read	Gets metadata about a Drive folder including its name, owner, sharing status, and parent folder.
`getMessage`	read	Fetches a single Gmail message by ID with headers, decoded plain-text body, HTML body, and a list of attachments (metadata only). Use listMessages to discover message IDs.
`getSheetsComment`	read	Gets a specific comment and its full reply thread from a Google Spreadsheet. Use listSheetsComments first to find the comment ID.
`getSpreadsheetInfo`	read	Gets metadata about a spreadsheet including its title, URL, and a list of all sheets with their dimensions.
`getTable`	read	Gets detailed information about a specific table including its columns, range, and properties. Use the table name or ID returned by listTables.
`getTableStructure`	read	Returns detailed structure for a table in a Google Document, including row/column counts and extracted cell text.
`groupRows`	read	Creates collapsible row groups in a Google Sheet using the Sheets API addDimensionGroup request. Each group specifies a range of rows (1-based, inclusive) to collapse.
`insertChart`	read	Inserts a chart into a Google Sheet. Supports bar, column, line, area, scatter, pie, donut, and treemap (hierarchical) chart types.
`insertDateChip`	read	Inserts a Google Docs date smart chip at a specific paragraph location. This creates a real date element, not plain text.
`insertImage`	read	Inserts an inline image into a Google Document. Provide either a publicly accessible URL or a local file path. Local files are automatically uploaded to Google Drive before insertion.
`insertPageBreak`	read	Inserts a page break at a character index in the document.
`insertPerson`	read	Inserts a Google Docs person smart chip at a specific paragraph location using an email address.
`insertRichLink`	read	Inserts a Google Docs rich link smart chip at a specific paragraph location. Use for Google resource links such as Drive files or Calendar events.
`insertSectionBreak`	read	Inserts a section break at a character index in the document. A section break starts a new section whose style (page orientation, margins, columns, page numbering) can then be customized with updateSectionStyle. Use sectionType=
`insertTable`	read	Inserts an empty table with the specified number of rows and columns at a character index in the document.
`insertTableWithData`	read	Inserts a table pre-populated with data at a specific index in the document.
`insertText`	read	Inserts text at a specific character index within a document. Use readDocument with format=
`listComments`	read	Lists all comments in a document with their IDs, authors, status, and quoted text. Returns data needed to call getComment, replyToComment, resolveComment, or deleteComment.
`listDocumentTables`	read	Lists tables in a Google Document with stable MCP table IDs, ranges, and dimensions. Use this before table-specific editing tools.
`listDocuments`	read	Lists Google Documents in your Drive, optionally filtered by name or content. Use modifiedAfter to find recently changed documents.
`listDrafts`	read	Lists Gmail drafts for the authenticated user. Returns draft IDs along with the recipient, subject, snippet, and date for each. Use sendDraft, updateDraft, or deleteDraft to act on a returned draft.
`listDriveFiles`	read	Lists files across Google Drive with optional filtering by type, folder, and ownership.
`listEvents`	read	Lists or searches Google Calendar events. Defaults to the user
`listFolderContents`	read	Lists files and subfolders within a Drive folder. Use folderId=
`listLabels`	read	Lists all Gmail labels for the authenticated user, including system labels (INBOX, SENT, STARRED, UNREAD, etc.) and custom user-created labels. Use the returned IDs with modifyMessageLabels or listMessages labelIds filter.
`listMessages`	read	Lists Gmail messages for the authenticated user. Supports the full Gmail search syntax via the q parameter (e.g.
`listSheetsComments`	read	Lists all comments in a Google Spreadsheet. Filter by sheet name, specific row(s), specific cell, or a cell range. Returns comment IDs needed for getSheetsComment, replyToSheetsComment, resolveSheetsComment, or deleteSheetsComment.
`listSmartChips`	read	Lists smart chips in a Google Document, including date elements, person mentions, and rich links.
`listSpreadsheets`	read	Lists spreadsheets in your Drive, optionally filtered by name or content.
`listTables`	read	Lists all tables in a spreadsheet or specific sheet. Use this to discover table names and IDs before performing table operations.
`listTabs`	read	Lists all tabs in a document with their IDs and hierarchy. Use the returned tab IDs with other tools
`modifyMessageLabels`	write	Adds and/or removes labels on a Gmail message. Use this to star (add STARRED), archive (remove INBOX), mark read (remove UNREAD), or apply custom labels. Discover label IDs with listLabels. At least one of addLabelIds or removeLabelIds must be provided.
`modifyText`	read	Combines text replacement/insertion and formatting in one atomic operation.
`moveFile`	read	Moves a file or folder to a different Drive folder. By default adds the new parent while keeping existing parents; set removeFromAllParents=true for a true move.
`protectRange`	read	Locks (protects) a range or an entire sheet to prevent accidental edits. Optionally specify a description. The protection applies to the authenticated user
`quickAddEvent`	read	Creates a calendar event from a natural-language string using Google Calendar\
`readCellFormat`	read	Reads the formatting/style of cells in a given range. Returns formatting details like bold, italic, fontSize, fontFamily, colors, alignment, borders, and number format per cell.
`readDocument`	read	Reads the content of a Google Document. Returns plain text by default. Use format=
`readSpreadsheet`	read	Reads data from a range in a spreadsheet. Returns rows as arrays. Use A1 notation for the range (e.g.,
`renameFile`	read	Renames a file or folder in Google Drive. Returns the updated file info.
`renameSheet`	read	Renames a sheet (tab) in a spreadsheet. Use getSpreadsheetInfo to find the numeric sheet ID.
`renameTab`	read	Renames a tab in a Google Docs document. Use listDocumentTabs to get tab IDs first.
`replaceDocumentWithMarkdown`	read	Replaces the entire document body with content parsed from markdown. Supports headings, bold, italic, strikethrough, links, and bullet/numbered lists. Use readDocument with format=
`replaceRangeWithMarkdown`	read	Replaces a specific character range in a document with formatted markdown content. Use readDocument with format=
`replaceTableRowData`	read	Replaces the plain-text contents of a single row in an existing Google Docs table while preserving the table structure and formatting.
`replyToComment`	read	Adds a reply to an existing comment thread. Use listComments or getComment to find the comment ID.
`replyToSheetsComment`	read	Adds a reply to an existing comment thread in a Google Spreadsheet. Use listSheetsComments or getSheetsComment to find the comment ID.
`resolveComment`	read	Marks a comment as resolved. Note: resolved status may not persist in the Google Docs UI due to a Drive API limitation.
`resolveSheetsComment`	read	Marks a comment as resolved in a Google Spreadsheet. Note: resolved status may not persist in the Sheets UI due to a Drive API limitation.
`searchDocuments`	read	Searches for documents by name, content, or both. Use listDocuments for browsing and this tool for targeted queries.
`searchDriveFiles`	read	Searches across all file types in Google Drive by name or content.
`sendDraft`	read	Sends an existing Gmail draft. After sending, the draft is removed and the message appears in Sent. This is the second half of the compose-review-send flow that pairs with createDraft.
`sendEmail`	read	Sends a plain-text email from the authenticated Gmail account. Supports cc/bcc and optional threading by passing replyToMessageId (which copies threadId and sets In-Reply-To/References so the reply lands in the same thread).
`setCellBorders`	read	Sets borders on a range of cells. Each side (top, bottom, left, right, innerHorizontal, innerVertical) can be configured independently with a style and color. Use style
`setColumnWidths`	read	Sets the width (in pixels) of one or more columns in a spreadsheet. Accepts multiple column specs in a single call, each targeting a single column or a contiguous range (e.g.,
`setDropdownValidation`	write	Adds or removes a dropdown list on a range of cells. Provide values to create a dropdown restricting input to those options. Omit values to remove dropdown validation from the range.
`setFilePermission`	read	Sets a sharing permission on a Drive file or folder. Common case: type=
`setRowHeights`	read	Sets a fixed pixel height for a range of rows in a spreadsheet. Useful for ensuring rows are tall enough to display wrapped text.
`trashMessage`	destructive	Moves a Gmail message to Trash. This is the same as clicking Delete in the Gmail UI — reversible from the Trash folder for 30 days. Not a permanent delete.
`triageInbox`	read	Composite tool: fetches the user
`ungroupAllRows`	read	Removes all row groupings from a sheet by deleting the entire row dimension group. Use before re-running groupRows to prevent duplicate collapse widgets from accumulating across report refreshes.
`updateAppsScriptContent`	read	Writes files into an existing Apps Script project. Default mode
`updateDraft`	read	Replaces the contents of an existing Gmail draft. The new contents fully overwrite the old draft (this is a full replace, not a patch). Use this when iterating on an AI-composed draft before sending.
`updateEvent`	write	Updates an existing Google Calendar event with PATCH semantics — only the fields you provide are changed; everything else stays the same. Common uses: reschedule (set start+end), retitle (set summary), add/remove attendees (set attendees array which fully replaces).
`updateTableBorders`	read	Applies table border styles to a Google Docs table range. Supports top/bottom/left/right borders across a cell range.
`updateTableCellStyle`	read	Applies cell-level formatting to a Google Docs table range, including background color, alignment, padding, and borders.
`updateTableColumnWidth`	read	Sets fixed widths for one or more columns in an existing Google Docs table.
`updateTableRange`	read	Modifies a table
`updateTableRowStyle`	read	Applies row-level styling to a Google Docs table, including minimum row height and optional pinned header rows.
`writeSpreadsheet`	read	Writes data to a range in a spreadsheet, overwriting existing values. Use appendRows to add data without overwriting.

Trust audit

CAUTIONgrade B · trust 89/100 Install with care. The audit found things worth knowing before you trust its output.

Layer	What it checks	Result
L0	Provenance & inventory	PASS
L1	Static analysis of the code	WARN
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	WARN
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: declared (6 observation(s))
Network: declared (2 observation(s))
Shell: none-observed
Dependencies: not all pinned
Secrets in source: none-found

Findings (12)

MEDIUMNetwork egress · net.raw_ip · CWE-200, CWE-319

src/index.ts:229

logger.info(`MCP Server running at ${process.env.BASE_URL || `http://0.0.0.0:${port}`}/mcp`);

MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59

deleteEvent, trashMessage

Why it matters. 2 tool(s) can delete or overwrite

Fix. prefer a read-only mode or scoped tokens; the page states the blast radius

LOWInventory / provenance · inv.hidden_file · CWE-1104

.prettierignore

.prettierignore

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose