Puter MCP
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
Search and work in Gmail, Calendar, Drive, Docs, Sheets and Slides across several Google accounts.
Pick the AI app you use, then copy the settings.
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Google Workspace for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "google": { "command": "npx", "args": [ "-y", "@foreverworks/mcp-google" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Google Workspace tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
SettingsDeveloperEdit Config
{
"mcpServers": {
"google": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-google"
]
}
}
}Use Google Workspace and tell me what you can do for me, then show me one thing✓ If Claude says it is using Google Workspace or shows a Google Workspace tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
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.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Google Workspace yet
Google Workspace runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Google Workspace
Works with Claude Code, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Google Workspace for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user google -- npx -y @foreverworks/mcp-google 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Google Workspace tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user google -- npx -y @foreverworks/mcp-googleYou should see Google Workspace listed as connected
Use Google Workspace and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Google Workspace or shows a Google Workspace tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
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.Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Google Workspace for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "google": { "command": "npx", "args": [ "-y", "@foreverworks/mcp-google" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Google Workspace tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Use Google Workspace and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Google Workspace or shows a Google Workspace tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
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.Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
Install Node.js on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Google Workspace for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "google": { "type": "stdio", "command": "npx", "args": [ "-y", "@foreverworks/mcp-google" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Google Workspace tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
node -vMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
Use Google Workspace and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Google Workspace or shows a Google Workspace tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
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.Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Claude Code
claude mcp add --scope user google -- npx -y @foreverworks/mcp-googleClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"google": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-google"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"google": {
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-google"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"google": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@foreverworks/mcp-google"
]
}
}
}CALENDAR_TIME_ZONE envGOOGLE_TOOLSETS envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
npm: @foreverworks/mcp-googleBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 16, 2026
The registry name was verified against the domain foreverworks.com (the registry checks domain ownership)
Code last changed 2 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for @foreverworks/mcp-google@0.2.0
Checks only this package version, not every dependency · checked Nov 15, 2026
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 2 days ago, and the latest version (0.2.0) reached the registry 14 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
In the same category: Puter MCP, XcodeBuildMCP, Anki MCP Server, Sosumi, Zapier
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
Search and read Apple developer documentation, HIG, and WWDC transcripts as Markdown.
Connects AI to thousands of apps through one Zapier server, such as Gmail, Google Sheets and Slack. You choose which actions the AI may use.
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
Search, read and organise the mail, calendars, Drive files, Docs, Sheets, Slides, Google Tasks, contacts and Meet transcripts of several Google accounts at once, from your AI assistant. It writes drafts, labels, filters, events, tasks, files, documents, comments and sharing. Nothing is money, and nothing deletes mail or a file for good: Gmail and Drive keep the trash for 30 days.
Mail stays a draft until you say send. Sending, sharing a file and publishing a revision are write tools that tell your assistant to wait for your explicit go. The server does not ask you itself; your client can, before each call. MCP_MAX_ACCESS=read makes the server read-only.
You need one or more Google accounts, a browser, and about ten minutes for npx -y @foreverworks/mcp-google setup, which walks you through the rest: an OAuth client of your own in a free Google Cloud project, made with a few clicks Google lets no program make, and one approval per product and account (what it does). Nothing to set by hand. The Workspace directory, Meet transcripts and smart notes, and focus time and out of office events need a Google Workspace account.
With Claude Code:
claude mcp add google -- npx -y @foreverworks/mcp-google
Claude Desktop (Settings, Developer, Edit Config) and most other clients read the same command as JSON:
{
"mcpServers": { "google": { "command": "npx", "args": ["-y", "@foreverworks/mcp-google"] } } }
Each runs the published package on Node 22.19 or newer. VS Code and the Claude Desktop bundle ask for each setting as they add the server; leave an optional one empty. Cursor reads each from your environment instead (${env:CALENDAR_TIME_ZONE} and so on), so set them before you start Cursor. Every setting is optional; Configuration says which ones you need for which tools.
git clone https://github.com/foreverworks/mcps.git && cd mcps
npm ci && npm run build claude mcp add google -- node "$PWD/servers/google/dist/index.js"
In a JSON configuration, the command is node and its one argument the full path of servers/google/dist/index.js. To share one running copy between several clients over HTTP, see docs/deploying.md.
Then run setup once, in a terminal, before your first question:
npx -y @foreverworks/mcp-google setup
It asks which products and accounts to connect, opens each Google page you need, picks up the file you download, and has you approve each product in your browser. At the end it prints the command above, with GOOGLE_TOOLSETS added if you chose only some products. Run it again to add an account or a product; it keeps what is already done.
Over HTTP (MCP_HTTP_PORT), one process serves every session, with one token cache per grant.
Nothing needs setting. setup saves the OAuth client and every grant in the server's state directory, ~/.local/state/mcps/google (on Windows %APPDATA%\mcps\google), and the server finds them there. Each grant records the address it was approved as, which is how the server knows which Google account each label stands for. A label is lowercase letters, digits and hyphens (personal, work, client-a), and stands for one Google identity in every product.
The variables below are for a deployment that keeps these files elsewhere, or lists its accounts itself. A variable that is set always wins over what setup saved, and health says where each value came from.
| Variable | Required | Meaning |
|---|---|---|
GOOGLE_OAUTH_CLIENT_FILE | no | The OAuth client JSON from the Google Cloud console (a Desktop app client), on which new grants are made. Default: the one setup saved, oauth-client.json in the state directory. Without either, a consent borrows the client of a credentials file the account already has. |
GMAIL_ADDRESSES | no | label=address,...: the Google address each account label stands for, in every product. Default: the address each grant recorded. A consent approved as anyone else is refused, and health checks Gmail grants against it. |
GMAIL_MODIFY_ACCOUNTS | no | label=path,...: where each mailbox's own gmail.modify grant is kept, which begin_consent writes. Default: every gmail/ /credentials.json in the state directory is a mailbox. Set, it lists the mailboxes on its own. |
CALENDAR_TIME_ZONE | no | The IANA zone a time without an offset is read in, and working hours default to; default the process's zone (TZ). |
Everything the server writes (token caches, grants, waiting consents, downloads) goes under GOOGLE_STATE_DIR: by default systemd's STATE_DIRECTORY, else $XDG_STATE_HOME/mcps/google, unless a variable below moves a product's part.
Every other variable (all optional)
| Variable | Meaning |
|---|---|
GMAIL_ACCOUNTS | label=path,...: a read-only (gmail.readonly) grant per mailbox, made elsewhere, for instance by a mail-sync program. A mailbox whose gmail.modify grant file does not exist runs on this one: it reads, and every write refuses. |
GMAIL_DEFAULT_ACCOUNT | The mailbox a one-mailbox read uses when none is named; default the first listed. |
GMAIL_STATE_DIR | Gmail's token caches, / /; default /gmail/state. |
GMAIL_ATTACHMENTS_DIR | Where attachments are saved, / /; default attachments/ in each mailbox's state folder. |
GMAIL_TIME_ZONE | The zone a reply's "On ... wrote:" line and a forward's Date line are written in, as Gmail writes them in its reader's zone; default CALENDAR_TIME_ZONE, else the process's zone. |
CALENDAR_ROOT | Calendar grants, / /credentials.json (written by consent); default /calendar. |
CALENDAR_DEFAULT_ACCOUNT | The account a one-account Calendar read uses; default the first by name. |
DRIVE_CREDENTIALS | Drive's one grant (written by consent); default /drive/credentials.json. |
DRIVE_STATE_DIR | Drive's token cache; default /drive/state. |
DRIVE_DOWNLOADS_DIR | Where download_file and download_revision save; default /drive/downloads. |
DRIVE_MIRROR_ROOT | A local copy of My Drive the server may read: upload_file also takes files from it, and sends each to the folder it mirrors. |
DRIVE_RCLONE_CONF | An rclone config whose remote's grant Drive borrows until it has its own. The remote must carry its own client_id and client_secret, since rclone's built-in client cannot be refreshed from here. Unset: no rclone. |
DRIVE_RCLONE_REMOTE | That remote's name; default gdrive. |
GOOGLE_EDITORS_ROOT | Docs, Sheets and Slides grants, / /credentials.json; default /editors. |
GOOGLE_EDITORS_STATE_DIR | Their token caches, / /, for when the grants must stay read-only; default / /state. |
GOOGLE_EDITORS_DRIVE_ACCOUNT | The label whose Docs, Sheets and Slides run on Drive's grant. Unset: none does. |
GOOGLE_EDITORS_DEFAULT_ACCOUNT | The account a Docs, Sheets or Slides read uses when none is named; default the one on Drive's grant, else the first. |
TASKS_ROOT | Google Tasks grants, / /credentials.json; default /tasks. |
CONTACTS_ROOT | The same for contacts and the directory; default /contacts. |
MEET_ROOT | The same for Meet's records; default /meet. |
GOOGLE_CONSENT_REDIRECT_URI | The loopback address a consent redirects to; default http://localhost:8123/. |
GOOGLE_STATE_DIR | The root of all of the above. |
GOOGLE_TOOLSETS | The products whose tools the server loads, separated by commas; default every one (Toolsets). |
The variables every server shares (MCP_HTTP_PORT, MCP_MAX_ACCESS, MCP_FILE_ROOTS, MCP_FILE_SCRIPT and the rest) are in docs/configuration.md.
Every tool definition the server hands your client travels with each request the client makes, so a client that only needs mail and calendars pays for Drive, Docs, Sheets and the rest all the same. GOOGLE_TOOLSETS names the products to load, separated by commas, the way GitHub's MCP server takes GITHUB_TOOLSETS. The tools of a product not loaded are not there at all: not in the tool list, not in the server's instructions, not in list_accounts or health. Unset, empty or all, every product is loaded, as before.
| Toolset | What it loads |
|---|---|
gmail | Mail: search, read, drafts, sending, labels, filters and attachments. |
calendar | Events, free/busy, finding a time, and answering invitations. |
drive | Drive's files and folders: paths, changes, upload and download. |
docs | Google Docs, simple edits and the full API, with editors_api_reference. |
sheets | Google Sheets, rows and ranges and the full API, with editors_api_reference. |
slides | Google Slides, decks from an outline and the full API, with editors_api_reference. |
collaboration | Comments, sharing and revisions on any Drive file. |
tasks | Google Tasks. |
contacts | find_people: contacts, saved addresses and a Workspace directory. |
meet | Meet's meetings, transcripts and smart notes. |
list_accounts, health, begin_consent and complete_consent are always loaded: every other tool takes a label list_accounts names, every remedy points to health, and consent is how any grant is made, including one a loaded product leans on (Meet reads a calend