Google Workspace Documents

What it is

A server spanning most of Google Workspace from one OAuth connection: documents and spreadsheets edited and formatted in place, Drive files managed, mail and calendar handled, and the Apps Script behind a file written.

What you get

• Docs read as text, JSON or markdown and edited precisely — text inserted, appended, replaced or deleted by index range, with find-and-replace and element location — readDocument, insertText, appendText, modifyText, deleteRange, findAndReplace, findElement
• Markdown written straight into a document, replacing the whole thing, one range, or appended — replaceDocumentWithMarkdown, replaceRangeWithMarkdown, appendMarkdown
• Real document formatting: character styles, paragraph styles, tables with or without data, images, page and section breaks, and section orientation and margins — applyTextStyle, applyParagraphStyle, insertTable, insertTableWithData, insertImage, insertPageBreak, insertSectionBreak, updateSectionStyle
• Document comments read, created against anchored text, replied to and resolved — listComments, addComment, replyToComment, resolveComment
• Sheets read and written by A1 range, in batches or appended, with sheets created, duplicated, copied between spreadsheets and renamed — readSpreadsheet, writeSpreadsheet, batchWrite, appendRows, addSheet, duplicateSheet, copySheetTo
• Spreadsheet presentation: cell formatting, borders per side, frozen headers, column widths and row heights, auto-resize, dropdown validation and protected ranges — formatCells, setCellBorders, freezeRowsAndColumns, setDropdownValidation, protectRange
• Named tables in Sheets, created with column types and appended to in a table-aware way — createTable, listTables, getTable, appendTableRows, updateTableRange
• Drive: documents and files listed, searched by name or content, created from a template, moved, copied, renamed, downloaded and trashed — searchDocuments, createDocumentFromTemplate, listDriveFiles, searchDriveFiles, moveFile, copyFile, downloadFile, deleteFile
• Gmail as a working inbox: messages listed with Gmail query syntax, read with decoded bodies, sent or replied in thread, labelled, trashed, and drafts composed, updated and sent — plus a composite triage call that returns unread mail with newsletter, meeting and action flags — listMessages, getMessage, sendEmail, modifyMessageLabels, createDraft, updateDraft, sendDraft, triageInbox
• Calendar events listed, created with attendees and an optional Meet link, patched, deleted with cancellations, or added from a sentence — listEvents, createEvent, updateEvent, deleteEvent, quickAddEvent
• Apps Script projects created — optionally bound to a Doc or Sheet — read, and written back, so onEdit triggers and custom menus are set up rather than pasted by hand — createAppsScriptProject, getAppsScriptContent, updateAppsScriptContent

Requirements

A Google Cloud OAuth client of desktop type, with the Docs, Sheets, Drive, Gmail and Calendar APIs enabled and a consent screen listing you as a test user, including the gmail.modify and calendar.events scopes. Authorize once with npx -y @a-bonus/google-docs-mcp auth, which saves a refresh token under ~/.config/google-docs-mcp/, then run the server with GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET set. Google Workspace domains can use a service account instead through SERVICE_ACCOUNT_PATH and GOOGLE_IMPERSONATE_USER, and there is a Cloud Run deployment for a shared team install. The Apps Script tools need two extra things: the Apps Script API switched on per Google account in your user settings, and a re-authorization on existing installs to pick up the script.projects scope.

Setup effort

Follow the published steps — GOOGLE_CLIENT_ID="your-client-id" GOOGLE_CLIENT_SECRET="your-client-secret" npx -y @a-bonus/google-docs-mcp auth

Tools you get

102 tools named in the project's documentation.

Requires

• npx on PATH
• GOOGLE_CLIENT_ID in your environment
• GOOGLE_CLIENT_SECRET in your environment