mcpbeat Sign in

Google Workspace MCP Server

local only

Google Workspace runs on your own machine — the client starts it, so there is no endpoint to ping. 388 installs a week from npm. Last commit 31 Oct 2026.

Search and work in Gmail, Calendar, Drive, Docs, Sheets and Slides across several Google accounts.

Installs per day peak 310 · avg 12
a month agotoday
388
Installs / week
npm · @foreverworks/mcp-google
1
Stars
0 open issues
31 Oct 2026
Last commit
3 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 1 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add google -e 'GOOGLE_OAUTH_CLIENT_FILE=<GOOGLE_OAUTH_CLIENT_FILE>' -e 'GMAIL_ADDRESSES=<GMAIL_ADDRESSES>' -e 'GMAIL_MODIFY_ACCOUNTS=<GMAIL_MODIFY_ACCOUNTS>' -- npx -y @foreverworks/mcp-google
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "google": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-google"
      ],
      "env": {
        "GMAIL_ADDRESSES": "<GMAIL_ADDRESSES>",
        "GMAIL_MODIFY_ACCOUNTS": "<GMAIL_MODIFY_ACCOUNTS>",
        "GOOGLE_OAUTH_CLIENT_FILE": "<GOOGLE_OAUTH_CLIENT_FILE>"
      }
    }
  }
}
~/.codex/config.toml
[mcp_servers.google]
command = "npx"
args = ["-y", "@foreverworks/mcp-google"]
env = { GOOGLE_OAUTH_CLIENT_FILE = "<GOOGLE_OAUTH_CLIENT_FILE>", GMAIL_ADDRESSES = "<GMAIL_ADDRESSES>", GMAIL_MODIFY_ACCOUNTS = "<GMAIL_MODIFY_ACCOUNTS>" }
.cursor/mcp.json
{
  "mcpServers": {
    "google": {
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-google"
      ],
      "env": {
        "GMAIL_ADDRESSES": "<GMAIL_ADDRESSES>",
        "GMAIL_MODIFY_ACCOUNTS": "<GMAIL_MODIFY_ACCOUNTS>",
        "GOOGLE_OAUTH_CLIENT_FILE": "<GOOGLE_OAUTH_CLIENT_FILE>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "google": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@foreverworks/mcp-google"
      ],
      "env": {
        "GMAIL_ADDRESSES": "<GMAIL_ADDRESSES>",
        "GMAIL_MODIFY_ACCOUNTS": "<GMAIL_MODIFY_ACCOUNTS>",
        "GOOGLE_OAUTH_CLIENT_FILE": "<GOOGLE_OAUTH_CLIENT_FILE>"
      }
    }
  }
}

Put your own values in place of <GOOGLE_OAUTH_CLIENT_FILE> (Path of your OAuth client's JSON (a Desktop app client from the Google Cloud console)), <GMAIL_ADDRESSES> (Each account's label and address, e.g. [email protected],[email protected]), <GMAIL_MODIFY_ACCOUNTS> (Where each mailbox's Gmail grant is kept, e.g. personal=/path/to/grants/gmail-personal.json; consent writes it there. Without it the other products work, but no mailbox does). The author’s registry entry marks them as required.

Optional settings from the registry entry, left out of the block above: CALENDAR_TIME_ZONE (The time zone a time without an offset is read in, e.g. Europe/Paris), GOOGLE_TOOLSETS (The products whose tools the server loads, separated by commas, e.g. gmail,calendar. Empty loads every product).

Alternatives to Google Workspace

same job, measured the same way
Google Workspace
by mindstone

Google Workspace MCP server for Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, and more

256 installs/wk local only
W
Workspace MCP
by taylorwilsdon

Google Workspace MCP server for Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Chat.

71 430 installs/wk local only
Gws Connector
by orieg

Multi-account Google Workspace MCP — Gmail, Calendar, Drive, Sheets, Docs with smart routing.

local only
Better Workspace MCP
by n24q02m

Google Workspace MCP — Docs, Drive, Calendar, Gmail, Sheets, Slides, Tasks, Chat, People, Forms

605 installs/wk local only
MCP Gee Sweet
by khuisman

MCP server for Google Workspace — Sheets, Drive, Docs (HTML or Markdown), Calendar, and Gmail.

15 970 installs/wk local only
Google Workspace MCP Server
by conorbronsdon

67 curated MCP tools for Google Workspace: Gmail, Calendar, Drive, Sheets, Docs, Slides, Tasks.

366 installs/wk local only
Google Drive MCP
by piotr-agier

Secure access to Google Drive, Docs, Sheets, Slides, and Calendar through MCP.

6 484 installs/wk local only
Google Workspace
by aaronsb

Give AI agents access to Gmail, Calendar, Drive, and more — multi-account, manifest-driven

1 861 installs/wk local only

Google Workspace — questions

Answers built from our own checks of this server.

Why is there no uptime for Google Workspace?
Google Workspace runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @foreverworks/mcp-google was installed 388 times last week.
How do I connect Google Workspace?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @foreverworks/mcp-google straight from npm; nothing to host, nothing to sign up for.
How many people use Google Workspace?
The npm package @foreverworks/mcp-google was installed 388 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Google Workspace open source?
Yes — it is published under the MIT licence, written in TypeScript and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.