google-services-mcp
One-liner: google-services-mcp is an MCP server that gives AI agents direct, multi-account access to your Google services (Gmail, Calendar, Meet, Drive, Contacts, Tasks, Sheets, Docs, Slides, YouTube, Forms) via OAuth.
Accounts — add a Google account via browser OAuth, list accounts, remove one, set the default, and check credential/token health (
google_account_*). Any tool accepts anaccountnickname to pick which connected account to use.Gmail — send, draft, reply, list, read, search, trash/untrash, permanently delete messages, manage labels (list/create/delete), modify labels, and list/download attachments (text decoded, binary as base64).
Calendar — list calendars and events (with query and time-range filters), create timed/all-day events, create events with Google Meet links, get/update/delete events.
Drive — list and search files, get metadata, upload/create files with text content, update or rename, delete, copy, create folders, share with users (reader/writer/commenter), download raw bytes, and export Google-native Docs/Sheets/Slides/Drawings to other formats (e.g. PDF).
Contacts — list, search (including non-connected people), and create contacts with name/email/phone.
Tasks — list task lists and tasks, create tasks with notes/due dates, complete tasks, delete tasks.
Sheets — create spreadsheets with tabs, read ranges, write values, append rows, get metadata, and send raw batchUpdate requests (formatting, sheet ops, etc.).
Docs — create documents, read as plain text or full structural JSON, insert text at an index, find-and-replace (template filling), and send raw batchUpdate requests.
Slides — create presentations, get presentation/slide-page structure, add or delete slides, find-and-replace across a deck, and send raw batchUpdate requests (textboxes, shapes, images, styling).
YouTube — search videos, get video details/statistics, list your uploads, list/create/delete playlists, add videos to playlists, and list channel subscriptions.
Forms — create forms, add text or multiple-choice questions, get form structure, and read submitted responses.
All tools are prefixed google_ so agents can chain services freely (e.g. read an email → create a Calendar event → attach a Drive file to a draft).
Provides tools to send, list, read, modify, and reply to email messages.
Allows managing calendars and events, including creating, reading, updating, deleting, and adding Google Meet links.
Allows creating documents, reading text, inserting or replacing text, and performing batch updates.
Provides tools to list, read, upload, update, delete, and share files in Google Drive.
Allows creating forms, adding questions, and reading responses.
Enables integration with Google Meet for creating meetings and generating meeting links.
Supports creating spreadsheets, reading/writing/appending cell ranges, and batch updating.
Enables creating presentations, adding or deleting slides, and find-and-replace text.
Provides tools to list task lists, and create, complete, or delete tasks.
Provides tools to search videos and manage uploads, playlists, and subscriptions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-services-mcp What's on my calendar today?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
google-services-mcp
MCP (Model Context Protocol) server that gives AI agents direct access to your Google services — Gmail, Calendar, Google Meet, Drive, Contacts, Tasks, Sheets, Docs, Slides, YouTube, and Forms — with multi-account OAuth support.
Add one account, wire the server into any MCP-compatible AI client, and your agent can read and send email, manage your calendar, find files in Drive, create documents and spreadsheets, and more — using your real Google data.
npm install -g google-services-mcp # or run without installing: npx -y google-services-mcpGoogle Workspace MCP
One MCP server for your Google Workspace apps — Gmail, Calendar, Google Meet,
Drive, Contacts, Tasks, Sheets, Docs, Slides, YouTube, and Forms — with
multi-account OAuth. Every tool is prefixed google_ (e.g. google_gmail_list,
google_calendar_list_events), so agents can combine services freely: read
email, then create a Calendar event from it, or attach a Drive file to a draft.
Related MCP server: google-cli-mcp
Features
Gmail — full Gmail access: send, draft, reply, list, read, search, label, and manage attachments
Calendar — Google Calendar events: list calendars, create/read/update/delete events, create Google Meet links
Drive — list, read, upload, update, delete, and share files
Contacts — list, search, and create contacts
Tasks — list task lists, create/complete/delete tasks
Sheets — create spreadsheets, read/write/append cell ranges, batch update
Docs — create documents, read text, insert/replace text, batch update
Slides — create presentations, add/delete slides, find-and-replace text
YouTube — search videos, manage uploads/playlists/subscriptions
Forms — create forms, add questions, read responses
Multi-account — connect several Google accounts, set a default, or pass an
accountargument to any toolOAuth 2.0 — one-time browser authorization; tokens are stored locally and refreshed automatically
134 tools across 11 services, all prefixed
google_. Full reference: docs/TOOLS.md.
Requirements
Node.js 24+ (CI runs Node 24; local dev on 26)
A Google Cloud project with the required APIs enabled and an OAuth 2.0 Desktop app client (one-time setup, ~10 minutes — see below)
Install
No install needed — run straight from npm via npx:
npx -y google-services-mcp --versionnpx downloads the package on first run and caches it. Every command in
this README (add, list, status, ...) works the same way:
npx -y google-services-mcp add personalPin a version for reproducibility — check the current release with
npm view google-services-mcp version, then run an exact version:npx -y google-services-mcp@<version> add personalMCP clients auto-launch this server, so pinning avoids surprise breakage when a new release ships.
Alternative: global install
Prefer a persistent google-services-mcp command (and faster MCP client
startup)?
npm install -g google-services-mcpThen replace npx -y google-services-mcp with google-services-mcp
everywhere below.
Release channels
latest— stable releases, published automatically when a merge tomainchanges something the package shipsbeta— preview builds, not a snapshot ofmain. The tag moves to whichever build ran last: a PR branch (each push to a non-draft PR, including the moment it is marked ready for review), av*-beta*tag, or a manual run frommain. Installing@betagets you unmerged code that is currently under review.
Install a stable version unless you specifically want to try a branch:
npx -y google-services-mcp@latest --version # stable
npx -y google-services-mcp@beta --version # preview buildAll publishes are signed with npm provenance (trusted publishing via GitHub Actions OIDC) — no npm token is stored in CI.
Quick start
Add a Google account — opens your browser for one-time authorization:
npx -y google-services-mcp add personalRegister the server with your MCP client (see MCP client configuration for Claude Desktop, opencode, and generic configs).
Start using it — ask your agent to "check my email" or "add an event to my calendar". Or add more accounts any time:
npx -y google-services-mcp add work.
MCP client configuration
The server speaks MCP over stdio. Point your client at the
google-services-mcp package via npx and pass your OAuth credentials via
environment variables. (If you installed globally, use google-services-mcp
as the command instead.)
opencode
In opencode.json (or your global config):
{
"mcp": {
"google-services-mcp": {
"type": "local",
"command": ["npx", "-y", "google-services-mcp"],
"enabled": true,
"environment": {
"GOOGLE_MCP_CLIENT_ID": "your-client-id",
"GOOGLE_MCP_CLIENT_SECRET": "your-client-secret"
}
}
}
}Claude Desktop / Cursor / other MCP clients
In the client's MCP settings file (e.g. claude_desktop_config.json):
{
"mcpServers": {
"google-services-mcp": {
"command": "npx",
"args": ["-y", "google-services-mcp"],
"env": {
"GOOGLE_MCP_CLIENT_ID": "your-client-id",
"GOOGLE_MCP_CLIENT_SECRET": "your-client-secret"
}
}
}
}Google Cloud setup (one-time)
Each installation uses its own OAuth client — credentials are per-user and never shared.
1. Create a project
Open the Google Cloud Console, choose
Select a project → New Project, and name it (e.g. google-services-mcp).
2. Configure the OAuth consent screen
APIs & Services → OAuth consent screen:
User type: External (required for regular Google accounts).
App name: anything you like (e.g.
Google Service MCP); support email = yours.Under Audience → Test users, click Add users and enter every Google account that will use this server. While the app is in Testing mode, accounts not on this list get
access blockedon the consent screen.
3. Enable the required APIs
APIs & Services → Library, search and Enable each:
Gmail API · Google Calendar API · Google Drive API · People API ·
Google Tasks API · Google Sheets API · Google Docs API ·
Google Slides API · YouTube Data API v3 · Google Forms API
Automated: with the
gcloudCLI installed and authenticated (gcloud auth login), enable all 10 APIs at once — idempotent, safe to re-run:bash scripts/enable-apis.sh --project your-project-id
4. Create OAuth client credentials
APIs & Services → Credentials → Create Credentials → OAuth client ID:
Application type: Desktop app.
Authorized redirect URIs:
http://localhost:8787.Copy the Client ID and Client Secret.
5. Provide the credentials
Set these environment variables (or put them in your MCP client config as above):
GOOGLE_MCP_CLIENT_ID=<your-oauth-client-id>
GOOGLE_MCP_CLIENT_SECRET=<your-oauth-client-secret>Optional:
GOOGLE_MCP_DIR=~/.google-services-mcp # where config and tokens live (default ~/.google-services-mcp)
GOOGLE_MCP_REDIRECT_PORT=8787 # local loopback port for OAuth (default 8787)
# A client secret supplied through the environment is never written to
# config.json; an invalid port fails at startup instead of binding a NaN port.
# Full redirect URI override. Takes precedence over REDIRECT_PORT and must
# exactly match a URI registered for this OAuth client in the Cloud Console.
# GOOGLE_MCP_REDIRECT_URI=http://127.0.0.1:8787/oauth2callback6. Connect your first account
npx -y google-services-mcp add personalA browser opens to the Google consent screen. After you approve, the account is
stored in ~/.google-services-mcp/accounts/ and ready to use. Repeat with a
different name (e.g. work) to connect more accounts.
CLI reference
npx -y google-services-mcp # run the MCP server over stdio
npx -y google-services-mcp add <name> # add a Google account (opens browser)
npx -y google-services-mcp list # list connected accounts
npx -y google-services-mcp remove <name> # remove an account
npx -y google-services-mcp set-default <name> # set the default account
npx -y google-services-mcp status # show config and token health
npx -y google-services-mcp --help # show helpFor AI agents
All tools are prefixed
google_, e.g.google_gmail_list,google_calendar_list_events,google_drive_list_files.The
accountargument selects which connected account a tool uses; omit it to use the default account.Agents can connect new accounts themselves via the
account_addtool — it opens the browser consent flow without needing the CLI.See docs/TOOLS.md for the full tool reference.
Security
OAuth tokens are stored in
~/.google-services-mcp/accounts/<account-name>.jsonwith restrictive file permissions. Keep them private — never commit them.The server never logs tokens or credentials.
Scopes requested: Gmail modify, Calendar, Drive, Contacts, Tasks, Sheets, Docs, Slides, YouTube, Forms, plus
userinfo.emailfor account display.If a client secret is ever exposed, rotate it in the Google Cloud Console (Credentials → your OAuth client → rotate secret).
Troubleshooting
Symptom | Cause / fix |
| Account not in Test users (setup step 2.3) — add it and retry |
| Exactly |
Tokens stop after ~7 days | App in Testing mode — re-run |
| GUI clients may lack PATH — use |
| Normal — click Advanced → Continue for personal use |
Local development
git clone https://github.com/nabheet/google-services-mcp.git
cd google-services-mcp
npm install
npm run build # compile to dist/
npm test # vitest, TDD suites (incl. hermetic E2E in test/e2e/)
npm run typecheck # tsc --noEmit
npm run dev # run from source with tsxSee AGENTS.md for architecture and conventions.
Releases (maintainers)
All publishing happens from GitHub Actions — no local npm login needed:
Stable — a merge to
mainthat changes shipping files auto-publishes the next patch version tolatestwith provenance, then creates avX.Y.Ztag and GitHub release. No manual steps. The next version is derived from the last publishedlateston npm, so repeated merges never collide; an intentional minor/major bump inpackage.jsonis honored.Preview — the
betadist-tag points at the last preview build, and is advanced by three things:a push to a non-draft PR in this repository (including the ready-for-review transition), as
<version>-beta.<run_number>a
v*-beta*tag pusha manual run: Actions → CI → Run workflow, which publishes a
0.x.x-beta.Xbuild ofmain
betatherefore tracks whichever build ran last, notmain. Uselatestfor anything you rely on.
Prerelease tags v*-beta* publish to beta with a prerelease GitHub release
(patch/minor builds for milestone testing). Publishing uses npm trusted
publishing (OIDC): configure it once per package at
npmjs.com/package/google-services-mcp/access with the GitHub repository
nabheet/google-services-mcp and workflow name ci.yml.
npm allows one trusted publisher per package and validates the calling
workflow's filename — all channels run from the same ci.yml file.
No NPM_TOKEN secret is required.
License
MIT
Available Tools
134 toolsgoogle_account_addAdd a Google accountA
Start the OAuth consent flow to connect a new Google account. Opens a browser for sign-in.
Inputs: name (required), openBrowser.
google_account_listList connected Google accountsA
List all connected accounts with their email and default status.
Inputs: no named parameters.
google_account_removeRemove a Google accountB
Disconnect an account and delete its stored tokens.
Inputs: name (required).
google_account_set_defaultSet the default Google accountA
Set which account is used when no account is specified.
Inputs: name (required).
google_account_statusGoogle services statusA
Show credential configuration, data directory, connected accounts and token health.
Inputs: no named parameters.
google_calendar_createCreate calendarC
Create a secondary calendar with a name, timezone, and description.
Inputs: summary (required), account, timeZone, description.
google_calendar_create_eventCreate calendar eventC
Create a timed or all-day event. All-day events use YYYY-MM-DD dates.
Inputs: end (required), start (required), summary (required), account, +12 more.
google_calendar_create_meetCreate event with Google MeetB
Create a calendar event with an attached Google Meet link.
Inputs: end (required), start (required), summary (required), account, +3 more.
google_calendar_deleteDelete calendarB
Delete a secondary calendar permanently (destructive).
Inputs: calendarId (required), account.
google_calendar_delete_eventDelete calendar eventB
Delete an event by ID.
Inputs: eventId (required), account, calendarId.
google_calendar_free_busyQuery calendar free/busyA
Query busy intervals across calendars to find free meeting windows. A calendar that could not be read returns errors instead of looking free.
Inputs: timeMax (required), timeMin (required), items, account, +1 more.
google_calendar_get_eventGet calendar eventA
Fetch a single event by ID.
Inputs: eventId (required), account, calendarId.
google_calendar_list_calendarsList calendarsB
List calendars the account can access.
Inputs: account, pageToken.
google_calendar_list_eventsList calendar eventsB
List upcoming events in a calendar, optionally filtered by time range or query.
Inputs: q, account, timeMax, timeMin, +3 more.
google_calendar_respondRespond to calendar event inviteA
Accept, decline, or mark tentative an event invite by setting the attendee responseStatus. The address must already be on the invite.
Inputs: eventId (required), responseStatus (required), email, account, +2 more.
google_calendar_updateUpdate calendarC
Update a calendar's name, color, timezone, or description (partial).
Inputs: calendarId (required), account, colorId, summary, +2 more.
google_calendar_update_eventUpdate calendar eventC
Update fields of an existing event (partial update).
Inputs: eventId (required), end, start, account, +13 more.
google_contacts_createCreate contactC
Create a new contact with a name and optional email/phone/address/organization/photo.
Inputs: name (required), email, phone, account, +3 more.
google_contacts_deleteDelete contactC
Delete a contact by resourceName.
Inputs: resourceName (required), account.
google_contacts_getGet contactB
Get a contact by resourceName with rich fields (name, email, phone, address, org).
Inputs: resourceName (required), account.
google_contacts_listList contactsC
List the account's contacts with names, emails and phones.
Inputs: account, pageSize, pageToken.
google_contacts_searchSearch contactsB
Search contacts (including non-connected) by name, email or phone.
Inputs: query (required), account.
google_contacts_updateUpdate contactB
Update a contact's name, email, phone, address, organization or photo. Multi-valued fields keep their other entries.
Inputs: resourceName (required), name, email, phone, +4 more.
google_docs_batch_updateBatch update documentC
Send raw Docs batchUpdate requests (styles, tables, headers, etc.).
Inputs: requests (required), documentId (required), account.
google_docs_createCreate documentA
Create a new Google Docs document with a title.
Inputs: title (required), account.
google_docs_delete_rangeDelete rangeC
Delete a range of content from a document.
Inputs: endIndex (required), documentId (required), startIndex (required), account.
google_docs_getGet documentB
Get the full Google Docs document (structural JSON).
Inputs: documentId (required), account.
google_docs_insert_inline_imageInsert inline imageB
Insert an inline image from a public URI and return the created object id.
Inputs: uri (required), index (required), documentId (required), account.
google_docs_insert_tableInsert tableC
Insert an empty table at a model index (a newline is added before it).
Inputs: rows (required), index (required), columns (required), documentId (required), +1 more.
google_docs_insert_textInsert text in documentB
Insert text into a document at an index or at the end.
Inputs: text (required), documentId (required), index, account.
google_docs_readRead document textB
Read a Google Docs document as plain text.
Inputs: documentId (required), account.
google_docs_replace_textReplace text in documentB
Replace all occurrences of a string in a document (template filling).
Inputs: find (required), replace (required), documentId (required), account, +1 more.
google_drive_copyCopy Drive fileC
Copy a file, optionally with a new name.
Inputs: fileId (required), name, account.
google_drive_create_folderCreate Drive folderC
Create a folder in Drive.
Inputs: name (required), account, parentFolderId.
google_drive_deleteDelete Drive fileA
Permanently delete a file from Drive. IRREVERSIBLE — prefer google_drive_trash (recoverable).
Inputs: fileId (required), account.
google_drive_delete_permissionDelete Drive file permissionC
Revoke a permission from a file by permission ID.
Inputs: fileId (required), permissionId (required), account.
google_drive_downloadDownload Drive fileA
Download a file's raw bytes (non-Google-native files). Text content returns decoded text; binary returns base64. Pass saveToPath to write bytes to a local file instead.
Inputs: fileId (required), account, saveToPath.
google_drive_exportExport Drive fileA
Export a Google-native file (Docs/Sheets/Slides/Drawings) to another format (e.g. application/pdf, text/plain, application/vnd.openxmlformats-officedocument.wordprocessingml.document). Pass saveToPath to write the exported bytes to a local file instead.
Inputs: fileId (required), mimeType (required), account, saveToPath.
google_drive_getGet Drive fileB
Get metadata for a single file by ID.
Inputs: fileId (required), account.
google_drive_listList Drive filesB
List files in Drive, newest first, with an optional query.
Inputs: query, account, pageSize, pageToken.
google_drive_list_permissionsList Drive file permissionsC
List who can access a file and with what role.
Inputs: fileId (required), account.
google_drive_moveMove Drive file to folderA
Move a file into a folder. Provide removeParentFolderId to also remove it from its current folder (true move); omit to add it to an additional folder.
Inputs: fileId (required), parentFolderId (required), account, removeParentFolderId.
google_drive_restoreRestore Drive file from trashB
Restore a trashed file (sets trashed: false).
Inputs: fileId (required), account.
google_drive_trashMove Drive file to trashA
Move a file to trash (recoverable via google_drive_restore). Safer than google_drive_delete.
Inputs: fileId (required), account.
google_drive_updateUpdate Drive fileC
Rename a file and/or replace its content (text or local file path).
Inputs: fileId (required), name, path, account, +2 more.
google_drive_uploadCreate/upload Drive fileA
Create a file in Drive, optionally with text content (blank Google-native file if omitted) or by local file path (binary-safe).
Inputs: name (required), mimeType (required), path, account, +2 more.
google_forms_add_questionAdd form questionC
Append a text or multiple-choice question to the end of a form.
Inputs: title (required), formId (required), type, account, +3 more.
google_forms_createCreate formC
Create a new Google Form with a title.
Inputs: title (required), account.
google_forms_deleteDelete formB
Permanently delete a form.
Inputs: formId (required), account.
google_forms_delete_questionDelete form questionC
Delete a question from a form by questionId.
Inputs: formId (required), questionId (required), account.
google_forms_export_responsesExport form responses to SheetsA
Append form responses to Sheets with a __google_forms_response_id column for deduplication by response ID. Existing rows are migrated by answer matching; added questions go after the ID column, while reordered columns fail safely.
Inputs: formId (required), spreadsheetId (required), account, sheetName.
google_forms_getGet formA
Get a Google Form's structure and questions.
Inputs: formId (required), account.
google_forms_move_questionMove form questionC
Reorder a question to a new position in the form.
Inputs: formId (required), newIndex (required), questionId (required), account.
google_forms_renameRename formC
Update a form's title.
Inputs: title (required), formId (required), account.
google_forms_responsesGet form responsesC
List responses submitted to a form.
Inputs: formId (required), account, pageSize, pageToken.
google_forms_update_questionUpdate form questionC
Update a question's title, description, options or required flag.
Inputs: formId (required), questionId (required), title, account, +3 more.
google_gmail_deleteDelete email permanentlyA
Permanently delete a message (irreversible).
Inputs: id (required), account.
google_gmail_drafts_createCreate email draftC
Create a draft email (not sent).
Inputs: to (required), body (required), subject (required), cc, +7 more.
google_gmail_drafts_deleteDelete email draftC
Delete a draft email.
Inputs: id (required), account.
google_gmail_drafts_getGet email draftA
Fetch a single draft with parsed headers and body.
Inputs: id (required), account.
google_gmail_drafts_listList email draftsC
List draft emails.
Inputs: account, pageToken, maxResults.
google_gmail_drafts_sendSend email draftB
Send an existing draft email.
Inputs: id (required), account.
google_gmail_drafts_updateUpdate email draftA
Replace the contents of an existing draft (recipients, subject, body, attachments).
Inputs: id (required), to (required), body (required), subject (required), +9 more.
google_gmail_filters_createCreate Gmail filterC
Create a Gmail filter with criteria and action (e.g. auto-archive).
Inputs: action, account, criteria.
google_gmail_filters_deleteDelete Gmail filterC
Delete a Gmail filter by ID.
Inputs: id (required), account.
google_gmail_filters_listList Gmail filtersB
List Gmail filters (auto-archive/apply rules).
Inputs: account.
google_gmail_getRead an emailA
Fetch a single message with parsed headers, body and attachment flags.
Inputs: id (required), account.
google_gmail_get_attachmentGet email attachmentA
Download a single attachment by message ID and attachment ID. Text-like files are returned decoded as text; binary files as base64. Attachments that would produce an inline result over 6 MB are rejected — pass saveToPath to write the raw bytes to a local file instead. The limit is measured on the JSON-RPC frame, not the raw bytes.
Inputs: id (required), attachmentId (required), partId, account, +2 more.
google_gmail_labels_createCreate email labelC
Create a custom Gmail label.
Inputs: name (required), account, labelListVisibility, messageListVisibility.
google_gmail_labels_deleteDelete email labelC
Delete a Gmail label.
Inputs: id (required), account.
google_gmail_labels_listList email labelsB
List all Gmail labels.
Inputs: account.
google_gmail_labels_updateUpdate email labelC
Update a Gmail label's name or visibility (partial).
Inputs: id (required), name, account, labelListVisibility, +1 more.
google_gmail_listList emailsB
List messages from the inbox, newest first, with an optional Gmail search query.
Inputs: query, account, pageToken, maxResults.
google_gmail_list_attachmentsList email attachmentsA
List attachments on a message (metadata only, no bytes).
Inputs: id (required), account.
google_gmail_modifyModify email labelsC
Add or remove labels on a message (e.g. mark read/unread, star, archive).
Inputs: id (required), account, addLabels, removeLabels.
google_gmail_replyReply to an emailA
Reply to an existing message inside its thread, preserving threading headers.
Inputs: body (required), threadId (required), messageId (required), from, +5 more.
google_gmail_sendSend emailC
Send an email from the connected account.
Inputs: to (required), body (required), subject (required), cc, +7 more.
google_gmail_sendas_createCreate send-as aliasC
Create a Gmail send-as alias (subject to domain/verification rules).
Inputs: sendAsEmail (required), account, isDefault, displayName.
google_gmail_sendas_listList send-as aliasesB
List Gmail send-as aliases.
Inputs: account.
google_gmail_threads_getRead an email threadB
Fetch a full conversation thread with every message parsed (headers, body, attachments).
Inputs: id (required), format, account.
google_gmail_threads_listList email threadsB
List conversation threads, newest first, with an optional Gmail search query.
Inputs: query, account, pageToken, maxResults.
google_gmail_trashTrash emailB
Move a message to trash.
Inputs: id (required), account.
google_gmail_untrashRestore email from trashA
Restore a message from trash.
Inputs: id (required), account.
google_gmail_vacation_getGet vacation responderC
Get the Gmail vacation (out-of-office) responder settings.
Inputs: account.
google_gmail_vacation_updateUpdate vacation responderC
Update the Gmail vacation (out-of-office) responder settings.
Inputs: account, endTime, startTime, enableAutoReply, +3 more.
google_sheets_add_sheetAdd spreadsheet tabC
Add a new tab (sheet) to a spreadsheet.
Inputs: title (required), spreadsheetId (required), index, account.
google_sheets_appendAppend to spreadsheetB
Append rows below the existing data in a sheet.
Inputs: range (required), values (required), spreadsheetId (required), account, +1 more.
google_sheets_batch_updateBatch update spreadsheetB
Send raw Sheets batchUpdate requests (add/delete sheets, formatting, etc.).
Inputs: requests (required), spreadsheetId (required), account.
google_sheets_createCreate spreadsheetB
Create a new spreadsheet, optionally with pre-made sheet tabs.
Inputs: title (required), sheets, account.
google_sheets_delete_rowsDelete rowsB
Delete rows from a sheet starting at a 0-based row index.
Inputs: sheetId (required), startIndex (required), spreadsheetId (required), account, +1 more.
google_sheets_delete_sheetDelete spreadsheet tabA
Permanently delete a tab (sheet) from a spreadsheet.
Inputs: sheetId (required), spreadsheetId (required), account.
google_sheets_getGet spreadsheetB
Get spreadsheet metadata and optionally cell values from a range.
Inputs: spreadsheetId (required), range, account.
google_sheets_get_named_rangesGet named rangesB
List named ranges on a spreadsheet.
Inputs: spreadsheetId (required), account.
google_sheets_insert_rowsInsert rowsC
Insert blank rows into a sheet at a 0-based row index.
Inputs: sheetId (required), startIndex (required), spreadsheetId (required), account, +1 more.
google_sheets_readRead spreadsheet rangeC
Read cell values from a range as rows of strings.
Inputs: range (required), spreadsheetId (required), account, majorDimension.
google_sheets_rename_sheetRename spreadsheet tabC
Rename a tab (sheet) in a spreadsheet.
Inputs: title (required), sheetId (required), spreadsheetId (required), account.
google_sheets_set_named_rangeSet named rangeC
Create a named range over a grid region.
Inputs: name (required), range (required), spreadsheetId (required), account.
google_sheets_writeWrite to spreadsheetA
Write rows of values starting at a range top-left cell (overwrites in place).
Inputs: range (required), values (required), spreadsheetId (required), account, +1 more.
google_slides_add_slideAdd slideB
Add a blank slide to a presentation.
Inputs: presentationId (required), account.
google_slides_batch_updateBatch update presentationC
Send raw Slides batchUpdate requests (create textboxes, shapes, images, style elements, etc.).
Inputs: requests (required), presentationId (required), account.
google_slides_createCreate presentationC
Create a new Google Slides presentation with a title.
Inputs: title (required), account.
google_slides_create_imageCreate imageC
Insert an image from a URL onto a slide. Sizes in points.
Inputs: url (required), pageObjectId (required), presentationId (required), x, +4 more.
google_slides_create_textboxCreate textboxC
Create a text box on a slide, optionally with initial text. Sizes in points.
Inputs: pageObjectId (required), presentationId (required), x, y, +4 more.
google_slides_delete_slideDelete slideB
Delete a slide by object ID.
Inputs: slideObjectId (required), presentationId (required), account.
google_slides_duplicate_slideDuplicate slideC
Duplicate a slide and return the new slide object ID.
Inputs: slideObjectId (required), presentationId (required), account.
google_slides_getGet presentationB
Get a Google Slides presentation (structural JSON).
Inputs: presentationId (required), account.
google_slides_get_pageGet slide pageA
Get the contents of a single slide page by object ID.
Inputs: pageObjectId (required), presentationId (required), account.
google_slides_move_slideMove slideB
Move a slide to a new position in the deck by insertion index.
Inputs: slideObjectId (required), insertionIndex (required), presentationId (required), account.
google_slides_replace_textReplace text in presentationB
Replace all occurrences of a string across a presentation (template filling).
Inputs: find (required), replace (required), presentationId (required), account, +1 more.
google_tasks_completeComplete taskB
Mark a task as completed.
Inputs: taskId (required), account, tasklistId.
google_tasks_createCreate taskB
Create a task, optionally with notes, due date, or as a subtask.
Inputs: title (required), due, notes, account, +2 more.
google_tasks_create_listCreate task listC
Create a new Google Tasks list.
Inputs: title (required), account.
google_tasks_deleteDelete taskC
Delete a task.
Inputs: taskId (required), account, tasklistId.
google_tasks_delete_listDelete task listC
Delete a Google Tasks list (removes its tasks).
Inputs: tasklistId (required), account.
google_tasks_listList tasksB
List tasks in a task list (default list if not specified).
Inputs: account, dueAfter, dueBefore, pageToken, +1 more.
google_tasks_list_listsList task listsC
List the account's Google Tasks lists.
Inputs: account, pageToken.
google_tasks_updateUpdate taskC
Update a task's title, notes, due date, or status (partial).
Inputs: taskId (required), due, notes, title, +3 more.
google_tasks_update_listRename task listC
Rename a Google Tasks list.
Inputs: title (required), tasklistId (required), account.
google_youtube_add_to_playlistAdd video to playlistC
Add a video to a playlist.
Inputs: videoId (required), playlistId (required), account.
google_youtube_create_playlistCreate YouTube playlistC
Create a private playlist for the user.
Inputs: title (required), account, description, privacyStatus.
google_youtube_delete_playlistDelete YouTube playlistB
Delete a playlist by ID.
Inputs: playlistId (required), account.
google_youtube_get_videoGet YouTube video detailsA
Get details, statistics and content details for a video.
Inputs: videoId (required), account.
google_youtube_insert_commentPost a YouTube commentC
Post a top-level comment on a video.
Inputs: text (required), videoId (required), account.
google_youtube_list_commentsList YouTube video commentsC
List comment threads for a video, most recent first.
Inputs: videoId (required), account, pageToken, maxResults.
google_youtube_list_playlistsList my playlistsC
List the user's YouTube playlists.
Inputs: account, pageToken, maxResults.
google_youtube_mark_comment_spamMark YouTube comment as spamC
Mark a comment as spam.
Inputs: commentId (required), account.
google_youtube_my_videosList my YouTube videosC
List the user's uploaded videos.
Inputs: account, pageToken, maxResults.
google_youtube_remove_from_playlistRemove video from playlistC
Remove a video from a playlist by playlist item ID.
Inputs: playlistItemId (required), account.
google_youtube_searchSearch YouTube videosB
Search YouTube for videos and return titles, IDs and channels.
Inputs: query (required), account, pageToken, maxResults.
google_youtube_set_comment_moderationSet YouTube comment moderation statusC
Hold, reject, or flag a comment as likely spam.
Inputs: commentId (required), moderationStatus (required), account.
google_youtube_subscriptionsList channel subscriptionsC
List the channels the user subscribes to.
Inputs: account, pageToken, maxResults.
google_youtube_update_videoUpdate YouTube video metadataC
Update a video's title, description, tags or privacy status.
Inputs: videoId (required), tags, title, account, +2 more.
google_youtube_uploadUpload YouTube videoB
Upload a video to YouTube. Provide a local file path (preferred) or base64 content. Defaults to private.
Inputs: title (required), path, tags, account, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 134 tools
Tools are strongly scoped by service and resource, so most are easy to distinguish (e.g., drive vs. docs vs. sheets prefixes). A few pairs overlap in intent—sheets_get vs. sheets_read, docs_get vs. docs_read, gmail_list vs. gmail_threads_list—but descriptions clarify the differences.
Names consistently use a google_<service>_ prefix and snake_case, making the surface predictable. There are minor ordering inconsistencies (e.g., gmail_threads_list vs. gmail_list, drive_create_folder vs. drive_upload), but overall the convention is readable.
With 134 tools, the surface is extremely large and unwieldy for an agent to navigate, even for a multi-service Google suite. Many niche and raw batch tools are included, pushing the count far beyond practical scoped-tool limits.
Coverage is broad across Drive, Gmail, Calendar, Docs, Sheets, Slides, YouTube, Forms, Tasks, Contacts, and account management, with most core CRUD/lifecycle operations present. Minor gaps exist, such as no YouTube video delete and limited Drive permission update/revision operations.
Maintenance
Related MCP Connectors
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server integrating multiple Google Workspace services including Gmail, Calendar, Drive, Sheets, Docs, Tasks, People, Forms, and Slides, enabling users to manage emails, events, files, documents, and more through natural language.15MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that exposes 17 Google Workspace APIs (e.g., Gmail, Drive, Calendar) as auto-generated tools for AI assistants, enabling natural language control of Google services.-
- AlicenseNot gradedqualityCmaintenanceLocal MCP server for reading/sending email via Gmail and managing Google Calendar events, enabling an AI agent to handle email and calendar operations through natural language.MIT
- FlicenseNot gradedqualityCmaintenanceAn MCP server that enables AI assistants to manage Google Workspace (Gmail and Calendar) through natural language, including reading/sending emails, managing events, and checking availability.-