All servers / Docs / Google Docs MCP server
Google Docs MCP server
MCP server for Google Docs, Sheets, Drive, Gmail, and Calendar
Tested by ConnectATDScore 90 out of 100. Tested 2026-11-18 on package version 2.1.2. Package: @a-bonus/google-docs-mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (9.1 seconds including download)
- Tools offered: 131
- Last published: 2026-11-17
- Weekly downloads (npm): 6,957
- License: ISC · Direct dependencies: 7
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
readDocument5 of 5 parameters describedReads 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.
listTabs2 of 2 parameters describedLists 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.
renameTab3 of 3 parameters describedRenames a tab in a Google Docs document. Use listDocumentTabs to get tab IDs first.
addTab5 of 5 parameters describedAdds 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.
appendText5 of 5 parameters describedAppends plain text to the end of a document. For formatted content, use appendMarkdown instead.
insertText5 of 5 parameters describedInserts text at a specific character index within a document. Use readDocument with format='json' to determine the correct index.
deleteRange5 of 5 parameters describedDeletes content within a character range [startIndex, endIndex) from a document. Use readDocument with format='json' to determine index positions.
modifyText6 of 6 parameters describedCombines 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.
findAndReplace6 of 6 parameters describedReplaces 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.
findElement3 of 3 parameters describedLocates 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.
listSuggestions1 of 1 parameter describedLists 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.
manageSuggestions3 of 3 parameters describedAccepts, 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.
insertTable5 of 5 parameters describedInserts an empty table with the specified number of rows and columns at a character index in the document.
insertTableWithData5 of 5 parameters describedInserts 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.
insertPageBreak3 of 3 parameters describedInserts a page break at a character index in the document.
insertSectionBreak4 of 4 parameters describedInserts 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.
updateSectionStyle11 of 11 parameters describedUpdates 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.
insertImage7 of 7 parameters describedInserts 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.
insertDateChip8 of 8 parameters describedInserts a Google Docs date smart chip at a specific paragraph location. This creates a real date element, not plain text.
insertPerson5 of 5 parameters describedInserts a Google Docs person smart chip at a specific paragraph location using an email address.
insertRichLink6 of 6 parameters describedInserts a Google Docs rich link smart chip at a specific paragraph location. Use for Google resource links such as Drive files or Calendar events.
listSmartChips2 of 2 parameters describedLists smart chips in a Google Document, including date elements, person mentions, and rich links.
cloneTable11 of 11 parameters describedClones a source Google Docs table into a target document, preserving text, column widths, row styles, cell styles, and pinned header rows where supported.
listDocumentTables2 of 2 parameters describedLists tables in a Google Document with stable MCP table IDs, ranges, and dimensions. Use this before table-specific editing tools.
getTableStructure3 of 3 parameters describedReturns detailed structure for a table in a Google Document, including row/column counts and extracted cell text.
findSectionsByHeading3 of 3 parameters describedFinds heading-based sections in a Google Document and reports heading ranges plus the first table that follows each heading.
replaceTableRowData5 of 5 parameters describedReplaces the plain-text contents of a single row in an existing Google Docs table while preserving the table structure and formatting.
deleteTableRows5 of 5 parameters describedDeletes one or more rows from an existing Google Docs table without replacing the whole document.
applyTextStyle5 of 5 parameters describedApplies 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.
batchApplyTextStyle4 of 4 parameters describedApplies 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.
applyParagraphStyle5 of 5 parameters describedApplies 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).
updateTableCellStyle13 of 13 parameters describedApplies cell-level formatting to a Google Docs table range, including background color, alignment, padding, and borders.
updateTableBorders7 of 11 parameters describedApplies table border styles to a Google Docs table range. Supports top/bottom/left/right borders across a cell range.
updateTableColumnWidth5 of 5 parameters describedSets fixed widths for one or more columns in an existing Google Docs table.
updateTableRowStyle7 of 7 parameters describedApplies row-level styling to a Google Docs table, including minimum row height and optional pinned header rows.
listComments1 of 1 parameter describedLists all comments in a document with their IDs, authors, status, and quoted text. Returns data needed to call getComment, replyToComment, resolveComment, or deleteComment.
getComment2 of 2 parameters describedGets a specific comment and its full reply thread. Use listComments first to find the comment ID.
addComment4 of 4 parameters describedAdds 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.
replyToComment3 of 3 parameters describedAdds a reply to an existing comment thread. Use listComments or getComment to find the comment ID.
resolveComment2 of 2 parameters describedMarks a comment as resolved. Note: resolved status may not persist in the Google Docs UI due to a Drive API limitation.
deleteComment2 of 2 parameters describedPermanently deletes a comment and all its replies from the document.
listDocuments4 of 4 parameters describedLists Google Documents in your Drive, optionally filtered by name or content. Use modifiedAfter to find recently changed documents.
searchDocuments4 of 4 parameters describedSearches for documents by name, content, or both. Use listDocuments for browsing and this tool for targeted queries.
listDriveFiles8 of 8 parameters describedLists 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.
searchDriveFiles9 of 9 parameters describedSearches 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.
getDocumentInfo1 of 1 parameter describedGets metadata about a document including its name, owner, sharing status, and modification history.
createFolder2 of 2 parameters describedCreates a new folder in Google Drive. Optionally places it inside an existing parent folder.
listFolderContents4 of 4 parameters describedLists files and subfolders within a Drive folder. Use folderId='root' to browse the top-level of the Drive.
getFolderInfo1 of 1 parameter describedGets metadata about a Drive folder including its name, owner, sharing status, and parent folder.
moveFile3 of 3 parameters describedMoves 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.
copyFile3 of 3 parameters describedCreates a copy of a file or document in Google Drive. Returns the new copy's ID and URL.
renameFile2 of 2 parameters describedRenames a file or folder in Google Drive. Returns the updated file info.
deleteFile2 of 2 parameters describedMoves a file or folder to the trash, or permanently deletes it. Set permanent=true for irreversible deletion.
createDocument4 of 4 parameters describedCreates 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.
createMarkdownFile3 of 3 parameters describedCreates 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.
readMarkdownFile2 of 2 parameters describedReads the raw markdown source of a native .md file in Drive (mimeType text/markdown). For Google Docs documents, use readDocument instead.
updateMarkdownFile3 of 3 parameters describedReplaces (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.
createDocumentFromTemplate4 of 4 parameters describedCreates 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.
downloadFile5 of 5 parameters describedDownloads 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.
setFilePermission7 of 7 parameters describedSets 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.
readSpreadsheet3 of 3 parameters describedReads data from a range in a spreadsheet. Returns rows as arrays. Use A1 notation for the range (e.g., "Sheet1!A1:C10").
writeSpreadsheet4 of 4 parameters describedWrites data to a range in a spreadsheet, overwriting existing values. Use appendRows to add data without overwriting.
batchWrite3 of 3 parameters describedWrites data to multiple ranges in a single API call. More efficient than multiple separate writeSpreadsheet calls when updating several ranges at once.
appendRows4 of 4 parameters describedAppends rows to the end of a sheet. Data is added after the last row with content in the specified range.
clearRange2 of 2 parameters describedClears all cell values in a range without deleting the cells themselves. Formatting is preserved.
getSpreadsheetInfo1 of 1 parameter describedGets metadata about a spreadsheet including its title, URL, and a list of all sheets with their dimensions.
addSheet2 of 2 parameters describedAdds a new sheet (tab) to an existing spreadsheet. Returns the new sheet's title and ID.
createSpreadsheet3 of 3 parameters describedCreates a new spreadsheet. Optionally places it in a specific folder and populates it with initial data.
listSpreadsheets3 of 3 parameters describedLists spreadsheets in your Drive, optionally filtered by name or content.
deleteSheet2 of 2 parameters describedDeletes a sheet (tab) from a spreadsheet. Use getSpreadsheetInfo to find the numeric sheet ID.
renameSheet3 of 3 parameters describedRenames a sheet (tab) in a spreadsheet. Use getSpreadsheetInfo to find the numeric sheet ID.
duplicateSheet3 of 3 parameters describedDuplicates a sheet (tab) within a spreadsheet, copying all values, formulas, formatting, validations, and conditional formatting. Use getSpreadsheetInfo to find the numeric sheet ID.
copySheetTo3 of 3 parameters describedCopies 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.
insertRows5 of 5 parameters describedInserts 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.
deleteRows4 of 4 parameters describedDeletes 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.
formatCells11 of 11 parameters describedApplies 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'.
readCellFormat2 of 2 parameters describedReads 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.
copyFormatting5 of 5 parameters describedCopies formatting (not values) from a source range to a destination range within the same spreadsheet. Copies bold, colors, borders, number formats, etc.
freezeRowsAndColumns4 of 4 parameters describedPins 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.
setColumnWidths3 of 3 parameters describedSets 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").
autoResizeColumns3 of 3 parameters describedAuto-resizes columns in a spreadsheet to fit their content. Optionally restrict to a column range (e.g., "A:S"); defaults to all columns.
autoResizeRows4 of 4 parameters describedAuto-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.
setRowHeights5 of 5 parameters describedSets a fixed pixel height for a range of rows in a spreadsheet. Useful for ensuring rows are tall enough to display wrapped text.
setCellBorders8 of 8 parameters describedSets 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.
protectRange5 of 5 parameters describedLocks (protects) a range or an entire sheet to prevent accidental edits. Optionally specify a description. The protection applies to the authenticated user's account.
getConditionalFormatting2 of 2 parameters describedLists 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).
deleteConditionalFormatting3 of 3 parameters describedDeletes one or more conditional formatting rules from a sheet by their index. Use getConditionalFormatting to list existing rules and their indices.
setDropdownValidation5 of 5 parameters describedAdds 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.
addConditionalFormatting12 of 12 parameters describedAdds 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.
groupRows3 of 3 parameters describedCreates 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.
ungroupAllRows3 of 3 parameters describedRemoves 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.
createSheetsComment6 of 6 parameters describedCreates 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.
createSheetsCellNote3 of 3 parameters describedCreates 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.
listSheetsComments7 of 7 parameters describedLists 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.
getSheetsComment2 of 2 parameters describedGets a specific comment and its full reply thread from a Google Spreadsheet. Use listSheetsComments first to find the comment ID.
replyToSheetsComment3 of 3 parameters describedAdds a reply to an existing comment thread in a Google Spreadsheet. Use listSheetsComments or getSheetsComment to find the comment ID.
resolveSheetsComment2 of 2 parameters describedMarks a comment as resolved in a Google Spreadsheet. Note: resolved status may not persist in the Sheets UI due to a Drive API limitation.
deleteSheetsComment2 of 2 parameters describedPermanently deletes a comment and all its replies from a Google Spreadsheet.
createTable6 of 6 parameters describedCreates a new named table with specific column types. Tables provide structured data with typed columns, automatic formatting, and special features like dropdown validation.
listTables2 of 2 parameters describedLists all tables in a spreadsheet or specific sheet. Use this to discover table names and IDs before performing table operations.
getTable2 of 2 parameters describedGets detailed information about a specific table including its columns, range, and properties. Use the table name or ID returned by listTables.
deleteTable3 of 3 parameters describedDeletes 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.
updateTableRange3 of 3 parameters describedModifies a table's dimensions (add/remove rows and columns) by updating its range. The new range must include the original table range.
appendTableRows4 of 4 parameters describedAppends 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.
insertChart16 of 16 parameters describedInserts 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.
deleteChart2 of 2 parameters describedDeletes a chart from a Google Spreadsheet by chart ID. The chart ID is returned when a chart is created with insertChart.
replaceDocumentWithMarkdown6 of 6 parameters describedReplaces 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.
appendMarkdown6 of 6 parameters describedAppends 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.
replaceRangeWithMarkdown6 of 6 parameters describedReplaces 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.
listMessages4 of 4 parameters describedLists 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.
getMessage2 of 2 parameters describedFetches 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.
downloadMessageAttachment5 of 5 parameters describedDownloads one attachment of a Gmail message to a local file. Get messageId and partId (or attachmentId) from getMessage. Returns the saved path, size in bytes, and MIME type. Will not overwrite an existing file unless overwrite is true. Requires GOOGLE_DOCS_MCP_DOWNLOAD_ROOTS to be set. Not available in remote (httpStream) mode.
sendEmail6 of 6 parameters describedSends 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).
trashMessage1 of 1 parameter describedMoves 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.
modifyMessageLabels3 of 3 parameters describedAdds 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.
listLabelsno parametersLists 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.
createDraft7 of 7 parameters describedCreates 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.
listDrafts2 of 2 parameters describedLists 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.
getDraft1 of 1 parameter describedFetches a single Gmail draft by ID with full headers, body, and a list of attachments (metadata only). Use listDrafts to discover draft IDs.
updateDraft8 of 8 parameters describedReplaces 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.
sendDraft1 of 1 parameter describedSends 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.
deleteDraft1 of 1 parameter describedPermanently 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.
triageInbox3 of 3 parameters describedComposite 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.
listEvents6 of 6 parameters describedLists 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.
createEvent9 of 9 parameters describedCreates 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.
updateEvent9 of 9 parameters describedUpdates 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).
deleteEvent3 of 3 parameters describedDeletes an event from a Google Calendar. This is permanent — the event is removed, not trashed. Use sendUpdates to email cancellations to attendees.
quickAddEvent3 of 3 parameters describedCreates 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.
createAppsScriptProject3 of 3 parameters describedCreates 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.
getAppsScriptContent3 of 3 parameters describedReads 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.
updateAppsScriptContent3 of 3 parameters describedWrites 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.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.