Skip to main content
Glama

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-mcp

Google 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 account argument to any tool

  • OAuth 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 --version

npx 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 personal

Pin 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 personal

MCP 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-mcp

Then replace npx -y google-services-mcp with google-services-mcp everywhere below.

Release channels

  • latest — stable releases, published automatically when a merge to main changes something the package ships

  • beta — preview builds, not a snapshot of main. 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), a v*-beta* tag, or a manual run from main. Installing @beta gets 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 build

All publishes are signed with npm provenance (trusted publishing via GitHub Actions OIDC) — no npm token is stored in CI.

Quick start

  1. Add a Google account — opens your browser for one-time authorization:

    npx -y google-services-mcp add personal
  2. Register the server with your MCP client (see MCP client configuration for Claude Desktop, opencode, and generic configs).

  3. 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).

APIs & Services → OAuth consent screen:

  1. User type: External (required for regular Google accounts).

  2. App name: anything you like (e.g. Google Service MCP); support email = yours.

  3. 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 blocked on 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 gcloud CLI 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:

  1. Application type: Desktop app.

  2. Authorized redirect URIs: http://localhost:8787.

  3. 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/oauth2callback

6. Connect your first account

npx -y google-services-mcp add personal

A 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 help

For AI agents

  • All tools are prefixed google_, e.g. google_gmail_list, google_calendar_list_events, google_drive_list_files.

  • The account argument selects which connected account a tool uses; omit it to use the default account.

  • Agents can connect new accounts themselves via the account_add tool — 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>.json with 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.email for 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

access blocked on consent

Account not in Test users (setup step 2.3) — add it and retry

redirect_uri_mismatch

Exactly http://localhost:8787 (no trailing slash), per OAuth client

Tokens stop after ~7 days

App in Testing mode — re-run add or Publish app

npx not found

GUI clients may lack PATH — use /usr/local/bin/npx or global install

Google hasn't verified this app

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 tsx

See AGENTS.md for architecture and conventions.

Releases (maintainers)

All publishing happens from GitHub Actions — no local npm login needed:

  1. Stable — a merge to main that changes shipping files auto-publishes the next patch version to latest with provenance, then creates a vX.Y.Z tag and GitHub release. No manual steps. The next version is derived from the last published latest on npm, so repeated merges never collide; an intentional minor/major bump in package.json is honored.

  2. Preview — the beta dist-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 push

    • a manual run: Actions → CI → Run workflow, which publishes a 0.x.x-beta.X build of main

    beta therefore tracks whichever build ran last, not main. Use latest for 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 tools
google_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_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_shareShare Drive fileB

Share a file with a user/group by email, anyone with the link, or a domain; optionally transfer ownership.

Inputs: role (required), fileId (required), type, email, +4 more.

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_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

    C2.9/5.0

    Scored across 134 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      MCP 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.
      15
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Local 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
    • F
      license
      Not graded
      quality
      C
      maintenance
      An 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.
      -