@a-bonus/google-docs-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 5 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y @a-bonus/google-docs-mcp@2.0.1
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 0 returned a result.
listDocuments | No usable answer tool reported an error: Tool 'listDocuments' execution failed: Google client initialization failed. Cannot start server tools. |
listDriveFiles | No usable answer tool reported an error: Tool 'listDriveFiles' execution failed: Google client initialization failed. Cannot start server tools. |
listSpreadsheets | No usable answer tool reported an error: Tool 'listSpreadsheets' execution failed: Google client initialization failed. Cannot start server tools. |
listLabels | No usable answer tool reported an error: Tool 'listLabels' execution failed: Google client initialization failed. Cannot start server tools. |
listDrafts | No usable answer tool reported an error: Tool 'listDrafts' execution failed: Google client initialization failed. Cannot start server tools. |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
readDocument documentId, format, maxLength, tabId, suggestionsViewMode
Reads the content of a Google Document. Returns plain text by default. Use format='markdown' to get formatted content suitable for editing and re-uploading with replaceDocumentWithMarkdown, or format='json' for the raw document structure.
listTabs documentId, includeContent
Lists all tabs in a document with their IDs and hierarchy. Use the returned tab IDs with other tools' tabId parameter to target a specific tab.
renameTab documentId, tabId, newTitle
Renames a tab in a Google Docs document. Use listDocumentTabs to get tab IDs first.
addTab documentId, title, parentTabId, index, iconEmoji
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's ID and properties.
appendText documentId, text, addNewlineIfNeeded, tabId, suggestMode
Appends plain text to the end of a document. For formatted content, use appendMarkdown instead.
125 more tools
insertText documentId, text, index, tabId, suggestMode
Inserts text at a specific character index within a document. Use readDocument with format='json' to determine the correct index.
deleteRange documentId, startIndex, endIndex, tabId, suggestMode
Deletes content within a character range [startIndex, endIndex) from a document. Use readDocument with format='json' to determine index positions.
modifyText documentId, target, text, style, tabId, suggestMode
Combines text replacement/insertion and formatting in one atomic operation. Can insert text at a position, replace a range or found text, apply formatting, or any combination. Use readGoogleDoc with format='json' to determine indices.
findAndReplace documentId, findText, replaceText, matchCase, tabId, suggestMode
Replaces all occurrences of a text string throughout the document (or a specific tab). Returns the number of replacements made. Use an empty replaceText to delete all matches.
findElement documentId, textQuery, elementType
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 "paragraph" or "table", lists those elements with their ranges and a text preview. Limitations: searches the first tab only (on multi-tab documents, tabs 2+ are not searched); paragraph listing covers top-level body paragraphs only, not paragraphs inside table cells (textQuery does search inside cells, but only one level deep — text in a table nested inside a table cell is not searched). At least one of textQuery or elementType is required.
listSuggestions documentId
Lists pending suggestion threads in a Google Doc, with the suggestion IDs needed for manageSuggestions (accept/reject/delete). Reads with suggestionsViewMode=SUGGESTIONS_INLINE across body, tabs, headers, footers and footnotes.
manageSuggestions documentId, action, suggestionIds
Accepts, rejects or deletes pending suggestion threads in a Google Doc (created in Suggesting mode or via suggestMode=true writes). Call listSuggestions first to get suggestion IDs.
insertTable documentId, rows, columns, index, tabId
Inserts an empty table with the specified number of rows and columns at a character index in the document.
insertTableWithData documentId, data, index, hasHeaderRow, tabId
Inserts a table pre-populated with data at a specific index in the document. All cell content is inserted in a single operation. Optionally bolds the first row as a header. Ragged rows are padded with empty cells to match the widest row.
insertPageBreak documentId, index, tabId
Inserts a page break at a character index in the document.
insertSectionBreak documentId, index, sectionType, tabId
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="NEXT_PAGE" when you want the new section to start on a fresh page (required for mixing portrait and landscape pages in a single document) and "CONTINUOUS" when the new section should begin inline without a page break.
updateSectionStyle documentId, startIndex, endIndex, flipPageOrientation, sectionType, marginTop, marginBottom, marginLeft, marginRight, pageNumberStart, tabId
Updates the style of a section identified by a character range. The range must cover the section whose style is changing — typically from the character right after an inserted section break to any index inside that section. Supports flipping page orientation (landscape <-> portrait), setting margins, and changing the section type. Common workflow for a landscape page: call insertSectionBreak with sectionType="NEXT_PAGE" before the landscape content, call insertSectionBreak again after it, then call updateSectionStyle on the range between the two breaks with flipPageOrientation=true.
insertImage documentId, imageUrl, localImagePath, index, width, height, tabId
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.
insertDateChip documentId, index, date, timeZoneId, locale, dateFormat, timeFormat, tabId
Inserts a Google Docs date smart chip at a specific paragraph location. This creates a real date element, not plain text.
insertPerson documentId, index, email, name, tabId
Inserts a Google Docs person smart chip at a specific paragraph location using an email address.
insertRichLink documentId, index, uri, mimeType, title, tabId
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.
listSmartChips documentId, tabId
Lists smart chips in a Google Document, including date elements, person mentions, and rich links.
cloneTable documentId, sourceDocumentId, sourceTableId, index, sourceTabId, targetTabId, copyColumnWidths, copyRowStyles, copyCellStyles, copyPinnedHeaderRows, copyHeaderBold
Clones a source Google Docs table into a target document, preserving text, column widths, row styles, cell styles, and pinned header rows where supported.
listDocumentTables documentId, tabId
Lists tables in a Google Document with stable MCP table IDs, ranges, and dimensions. Use this before table-specific editing tools.
getTableStructure documentId, tableId, tabId
Returns detailed structure for a table in a Google Document, including row/column counts and extracted cell text.
findSectionsByHeading documentId, headings, tabId
Finds heading-based sections in a Google Document and reports heading ranges plus the first table that follows each heading.
replaceTableRowData documentId, tableId, rowIndex, values, tabId
Replaces the plain-text contents of a single row in an existing Google Docs table while preserving the table structure and formatting.
deleteTableRows documentId, tableId, rowStart, rowCount, tabId
Deletes one or more rows from an existing Google Docs table without replacing the whole document.
applyTextStyle documentId, target, style, tabId, suggestMode
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.
batchApplyTextStyle documentId, operations, tabId, suggestMode
Applies character-level formatting (bold, italic, color, font, etc.) to MANY ranges in a single tool call, instead of one applyTextStyle call per range. Built for scripts that colour dozens or hundreds of cues: do one readDocument (format="json") pass, compute every range from that one read, then pass them all here as one operations[] array. Internally chunks into batches of up to 50 requests per Docs API call (Google's per-request-array limit), so 100+ operations still cost only 2-3 API calls instead of 100+ round trips.
applyParagraphStyle documentId, target, style, tabId, suggestMode
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).
updateTableCellStyle documentId, tableId, rowStart, rowEnd, columnStart, columnEnd, backgroundColor, contentAlignment, paddingTopPt, paddingBottomPt, paddingLeftPt, paddingRightPt, tabId
Applies cell-level formatting to a Google Docs table range, including background color, alignment, padding, and borders.
updateTableBorders documentId, tableId, rowStart, rowEnd, columnStart, columnEnd, top, bottom, left, right, tabId
Applies table border styles to a Google Docs table range. Supports top/bottom/left/right borders across a cell range.
updateTableColumnWidth documentId, tableId, columnIndices, widthPt, tabId
Sets fixed widths for one or more columns in an existing Google Docs table.
updateTableRowStyle documentId, tableId, rowIndices, minRowHeightPt, preventOverflow, pinnedHeaderRowsCount, tabId
Applies row-level styling to a Google Docs table, including minimum row height and optional pinned header rows.
listComments documentId
Lists all comments in a document with their IDs, authors, status, and quoted text. Returns data needed to call getComment, replyToComment, resolveComment, or deleteComment.
getComment documentId, commentId
Gets a specific comment and its full reply thread. Use listComments first to find the comment ID.
addComment documentId, startIndex, endIndex, content
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.
replyToComment documentId, commentId, content
Adds a reply to an existing comment thread. Use listComments or getComment to find the comment ID.
resolveComment documentId, commentId
Marks a comment as resolved. Note: resolved status may not persist in the Google Docs UI due to a Drive API limitation.
deleteComment documentId, commentId
Permanently deletes a comment and all its replies from the document.
listDocuments maxResults, query, orderBy, modifiedAfter
Lists Google Documents in your Drive, optionally filtered by name or content. Use modifiedAfter to find recently changed documents.
searchDocuments query, searchIn, maxResults, modifiedAfter
Searches for documents by name, content, or both. Use listDocuments for browsing and this tool for targeted queries.
listDriveFiles maxResults, mimeType, folderId, orderBy, sortDirection, ownedByMe, sharedWithMe, modifiedAfter
Lists files across Google Drive with optional filtering by type, folder, and ownership. Unlike listDocuments (which only returns Google Docs), this tool works with all file types (Sheets, PDFs, images, folders, etc.) and supports sort direction and size-based ordering. Use mimeType shortcuts: "document", "spreadsheet", "presentation", "folder", "form", "pdf", "zip" or pass any full MIME type string.
searchDriveFiles query, searchIn, mimeType, folderId, orderBy, sortDirection, maxResults, modifiedAfter, pageToken
Searches across all file types in Google Drive by name or content. Unlike searchDocuments (which only searches Google Docs), this tool finds Sheets, PDFs, presentations, folders, and any other Drive file. Supports filtering by MIME type, scoping to a specific folder subtree, controllable sort order, and pagination via pageToken.
getDocumentInfo documentId
Gets metadata about a document including its name, owner, sharing status, and modification history.
createFolder name, parentFolderId
Creates a new folder in Google Drive. Optionally places it inside an existing parent folder.
listFolderContents folderId, includeSubfolders, includeFiles, maxResults
Lists files and subfolders within a Drive folder. Use folderId='root' to browse the top-level of the Drive.
getFolderInfo folderId
Gets metadata about a Drive folder including its name, owner, sharing status, and parent folder.
moveFile fileId, newParentId, removeFromAllParents
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.
copyFile fileId, newName, parentFolderId
Creates a copy of a file or document in Google Drive. Returns the new copy's ID and URL.
renameFile fileId, newName
Renames a file or folder in Google Drive. Returns the updated file info.
deleteFile fileId, permanent
Moves a file or folder to the trash, or permanently deletes it. Set permanent=true for irreversible deletion.
createDocument title, parentFolderId, initialContent, contentFormat
Creates a new empty Google Document. Optionally places it in a specific folder and adds initial text content. For a native Markdown (.md) file instead, use createMarkdownFile.
createMarkdownFile title, parentFolderId, content
Creates a native Markdown (.md) file in Google Drive. Unlike createDocument (which makes a Google Doc and converts markdown to formatted content), this keeps the raw .md source so Docs/Drive edit it natively with live preview and comments preserved.
readMarkdownFile fileId, maxLength
Reads the raw markdown source of a native .md file in Drive (mimeType text/markdown). For Google Docs documents, use readDocument instead.
updateMarkdownFile fileId, content, append
Replaces (or appends to) the raw markdown source of a native .md file in Drive. Edits apply as file content, not as Docs suggestions: use listSuggestions/manageSuggestions only for Google Docs.
createDocumentFromTemplate templateId, newTitle, parentFolderId, replacements
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.
downloadFile fileId, savePath, exportMimeType, extractText, returnAs
Downloads any file from Google Drive to a local path. For Google Workspace files (Docs, Sheets, Slides), exports to a specified format (defaults to text/markdown for Docs, text/csv for Sheets). For regular files (PDFs, images, etc.), downloads the raw bytes. Optionally extracts and returns text content for text-based files.
setFilePermission fileId, role, type, emailAddress, domain, sendNotificationEmail, allowFileDiscovery
Sets a sharing permission on a Drive file or folder. Common case: type='anyone' with role='reader' enables 'anyone with the link can view'. Use type='user' with emailAddress to grant a specific person access. Returns the created permission record.
readSpreadsheet spreadsheetId, range, valueRenderOption
Reads data from a range in a spreadsheet. Returns rows as arrays. Use A1 notation for the range (e.g., "Sheet1!A1:C10").
writeSpreadsheet spreadsheetId, range, values, valueInputOption
Writes data to a range in a spreadsheet, overwriting existing values. Use appendRows to add data without overwriting.
batchWrite spreadsheetId, data, valueInputOption
Writes data to multiple ranges in a single API call. More efficient than multiple separate writeSpreadsheet calls when updating several ranges at once.
appendRows spreadsheetId, range, values, valueInputOption
Appends rows to the end of a sheet. Data is added after the last row with content in the specified range.
clearRange spreadsheetId, range
Clears all cell values in a range without deleting the cells themselves. Formatting is preserved.
getSpreadsheetInfo spreadsheetId
Gets metadata about a spreadsheet including its title, URL, and a list of all sheets with their dimensions.
addSheet spreadsheetId, sheetTitle
Adds a new sheet (tab) to an existing spreadsheet. Returns the new sheet's title and ID.
createSpreadsheet title, parentFolderId, initialData
Creates a new spreadsheet. Optionally places it in a specific folder and populates it with initial data.
listSpreadsheets maxResults, query, orderBy
Lists spreadsheets in your Drive, optionally filtered by name or content.
deleteSheet spreadsheetId, sheetId
Deletes a sheet (tab) from a spreadsheet. Use getSpreadsheetInfo to find the numeric sheet ID.
renameSheet spreadsheetId, sheetId, newName
Renames a sheet (tab) in a spreadsheet. Use getSpreadsheetInfo to find the numeric sheet ID.
duplicateSheet spreadsheetId, sheetId, newSheetName
Duplicates a sheet (tab) within a spreadsheet, copying all values, formulas, formatting, validations, and conditional formatting. Use getSpreadsheetInfo to find the numeric sheet ID.
copySheetTo sourceSpreadsheetId, sheetId, destinationSpreadsheetId
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.
insertRows spreadsheetId, sheetName, startRow, count, inheritFromBefore
Inserts empty rows into a sheet, shifting existing rows down (like "Insert rows above" in the Sheets UI). Formulas and references to shifted cells are adjusted by Google Sheets automatically. Use this instead of rewriting a block of data when new rows are needed in the middle of a sheet.
deleteRows spreadsheetId, sheetName, startRow, endRow
Deletes a range of rows from a sheet, shifting the rows below up (like "Delete rows" in the Sheets UI). Unlike clearRange, the rows themselves are removed, including their formatting. This cannot be undone through the API — read the range first if unsure.
formatCells spreadsheetId, range, bold, italic, fontSize, foregroundColor, backgroundColor, horizontalAlignment, verticalAlignment, wrapStrategy, numberFormat
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 '1:1' to format an entire header row, 'A:A' for an entire column, or 'A1:D1' for specific cells. Use numberFormat to control how values are displayed (e.g. as numbers, text, dates) or to clear a format by setting type to 'TEXT'.
readCellFormat spreadsheetId, range
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.
copyFormatting spreadsheetId, sourceSheetName, sourceRange, destinationSheetName, destinationRange
Copies formatting (not values) from a source range to a destination range within the same spreadsheet. Copies bold, colors, borders, number formats, etc.
freezeRowsAndColumns spreadsheetId, sheetName, frozenRows, frozenColumns
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.
setColumnWidths spreadsheetId, sheetName, columnWidths
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., "A", "B:D").
autoResizeColumns spreadsheetId, sheetName, columns
Auto-resizes columns in a spreadsheet to fit their content. Optionally restrict to a column range (e.g., "A:S"); defaults to all columns.
autoResizeRows spreadsheetId, sheetName, startRow, endRow
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.
setRowHeights spreadsheetId, sheetName, startRow, endRow, pixelSize
Sets a fixed pixel height for a range of rows in a spreadsheet. Useful for ensuring rows are tall enough to display wrapped text.
setCellBorders spreadsheetId, range, top, bottom, left, right, innerHorizontal, innerVertical
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 "NONE" to remove a border.
protectRange spreadsheetId, sheetName, range, description, warningOnly
Locks (protects) a range or an entire sheet to prevent accidental edits. Optionally specify a description. The protection applies to the authenticated user's account.
getConditionalFormatting spreadsheetId, sheetName
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).
deleteConditionalFormatting spreadsheetId, sheetName, ruleIndices
Deletes one or more conditional formatting rules from a sheet by their index. Use getConditionalFormatting to list existing rules and their indices.
setDropdownValidation spreadsheetId, range, values, strict, inputMessage
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.
addConditionalFormatting spreadsheetId, sheetName, ranges, conditionType, conditionValues, backgroundColor, bold, italic, strikethrough, underline, foregroundColor, fontSize
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 "=$A1>$B1". Note: each call appends a new rule — use deleteConditionalFormatting to remove existing rules before re-adding.
groupRows spreadsheetId, sheetName, groups
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.
ungroupAllRows spreadsheetId, sheetName, totalRows
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.
createSheetsComment spreadsheetId, content, sheetName, cell, range, includeCellLink
Creates a new comment in a Google Spreadsheet. When you target a specific cell or range, a click-through link to that location is added to the comment body by default (includeCellLink), letting users jump to the cell. Note: the Drive API cannot natively anchor spreadsheet comments to a cell in the Sheets UI, so the comment itself appears under "All comments" — the click-through link is the supported way to navigate to the target.
createSheetsCellNote spreadsheetId, range, content
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.
listSheetsComments spreadsheetId, sheetName, row, rows, cell, range, includeResolved
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.
getSheetsComment spreadsheetId, commentId
Gets a specific comment and its full reply thread from a Google Spreadsheet. Use listSheetsComments first to find the comment ID.
replyToSheetsComment spreadsheetId, commentId, content
Adds a reply to an existing comment thread in a Google Spreadsheet. Use listSheetsComments or getSheetsComment to find the comment ID.
resolveSheetsComment spreadsheetId, commentId
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.
deleteSheetsComment spreadsheetId, commentId
Permanently deletes a comment and all its replies from a Google Spreadsheet.
createTable spreadsheetId, name, range, columns, hasHeaderRow, hasFooterRow
Creates a new named table with specific column types. Tables provide structured data with typed columns, automatic formatting, and special features like dropdown validation.
listTables spreadsheetId, sheetName
Lists all tables in a spreadsheet or specific sheet. Use this to discover table names and IDs before performing table operations.
getTable spreadsheetId, tableIdentifier
Gets detailed information about a specific table including its columns, range, and properties. Use the table name or ID returned by listTables.
deleteTable spreadsheetId, tableIdentifier, deleteData
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.
updateTableRange spreadsheetId, tableIdentifier, range
Modifies a table's dimensions (add/remove rows and columns) by updating its range. The new range must include the original table range.
appendTableRows spreadsheetId, tableIdentifier, values, valueInputOption
Appends rows to the end of a table using table-aware insertion. This method respects footers and automatically inserts rows before the footer if one exists.
insertChart spreadsheetId, sheetName, chartType, stackedType, title, dataRange, headerRow, labelColumnIndex, parentColumnIndex, valueColumnIndex, anchorRow, anchorColumn, offsetXPixels, offsetYPixels, widthPixels, heightPixels
Inserts a chart into a Google Sheet. Supports bar, column, line, area, scatter, pie, donut, and treemap (hierarchical) chart types. For treemap charts, the data must have a label column and a parent label column (use empty string for root nodes) plus a numeric size column. Chart is placed as an overlay at the specified anchor cell.
deleteChart spreadsheetId, chartId
Deletes a chart from a Google Spreadsheet by chart ID. The chart ID is returned when a chart is created with insertChart.
replaceDocumentWithMarkdown documentId, markdown, preserveTitle, tabId, firstHeadingAsTitle, suggestMode
Replaces the entire document body with content parsed from markdown. Supports headings, bold, italic, strikethrough, links, and bullet/numbered lists. Use readDocument with format='markdown' first to get the current content, edit it, then call this tool to apply changes.
appendMarkdown documentId, markdown, addNewlineIfNeeded, tabId, firstHeadingAsTitle, suggestMode
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.
replaceRangeWithMarkdown documentId, startIndex, endIndex, markdown, tabId, suggestMode
Replaces a specific character range in a document with formatted markdown content. Use readDocument with format='json' to determine the start and end indices of the content you want to replace. Supports headings, bold, italic, strikethrough, links, bullet/numbered lists, code blocks, horizontal rules, and tables.
listMessages maxResults, q, labelIds, includeSpamTrash
Lists Gmail messages for the authenticated user. Supports the full Gmail search syntax via the q parameter (e.g. "is:unread", "from:alice@example.com", "subject:invoice newer_than:7d"). Returns message IDs with sender, subject, date, and snippet for each result.
getMessage messageId, format
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.
sendEmail to, subject, body, cc, bcc, replyToMessageId
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).
trashMessage messageId
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.
modifyMessageLabels messageId, addLabelIds, removeLabelIds
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.
listLabels
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.
createDraft to, subject, body, cc, bcc, replyToMessageId, attachments
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 and local file attachments. The response includes the From address of the account the draft was created in.
listDrafts maxResults, q
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.
getDraft draftId
Fetches a single Gmail draft by ID with full headers, body, and a list of attachments (metadata only). Use listDrafts to discover draft IDs.
updateDraft draftId, to, subject, body, cc, bcc, replyToMessageId, attachments
Replaces the contents of an existing Gmail draft. The new contents fully overwrite the old draft (this is a full replace, not a patch), attachments included: pass attachments again or the draft loses them. The draft stays in its thread unless replyToMessageId names another message. Use this when iterating on an AI-composed draft before sending.
sendDraft draftId
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.
deleteDraft draftId
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.
triageInbox maxResults, additionalQuery, bodyExcerptLength
Composite tool: fetches the user's most recent unread Gmail messages with full content and heuristic categorization in a single call. Returns headers, body excerpts, labels, plus per-message signals (newsletter, meeting reference, contains question, action requested) AND aggregate stats (total unread, top senders, breakdown by category). Designed for AI inbox triage workflows — use the returned data to decide which messages need a reply, can be archived, or warrant a draft response. Pairs naturally with createDraft, modifyMessageLabels, and trashMessage.
listEvents calendarId, q, timeMin, timeMax, maxResults, singleEvents
Lists or searches Google Calendar events. Defaults to the user's primary calendar starting now. Use timeMin/timeMax (RFC3339 timestamps) to bound the window, q for free-text search, and maxResults to cap the count. Returns event IDs needed for updateEvent and deleteEvent.
createEvent calendarId, summary, description, location, start, end, attendees, sendUpdates, conferenceData
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.
updateEvent calendarId, eventId, summary, description, location, start, end, attendees, sendUpdates
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).
deleteEvent calendarId, eventId, sendUpdates
Deletes an event from a Google Calendar. This is permanent — the event is removed, not trashed. Use sendUpdates to email cancellations to attendees.
quickAddEvent calendarId, text, sendUpdates
Creates a calendar event from a natural-language string using Google Calendar's quick-add parser. Examples: "Lunch with Sarah tomorrow at 12pm", "Dentist appointment next Tuesday 3-4pm", "Team standup every weekday 9am". Faster than createEvent when you don't need attendees, descriptions, or precise control over fields.
createAppsScriptProject title, parentId, files
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.
getAppsScriptContent scriptId, versionNumber, includeSource
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.
updateAppsScriptContent scriptId, files, mode
Writes files into an existing Apps Script project. Default mode "merge" replaces same-named files and keeps the rest; mode "replace" makes the project contain exactly the files passed in. The manifest is preserved automatically.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | ISC |
|---|---|
| Needs | node >=22 |
| Source | not stated |
| Install scripts | protobufjs declare them. This runner does not run them. |
| Tarball | sha512-puwoFYBHB9oTR8gZO9uifQVK1R/zX2k/oS85ZW60rZ3q5UsXwZBfJJjc83+n2SpRsTRBphllcLTNRxkmNL/VYQ== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 2.0.1 | 2026-11-16 | Starts with no setup | 130 |
| 1.11.3 | 2026-11-12 | Needs setup before it starts | 0 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40a-bonus/google-docs-mcp)
New version out? Ask for a fresh report.