Google Docs MCP Server

by pulsemcpcom.pulsemcp/google-docsv0.1.4

MCP server for Google Docs integration with OAuth2 and service account support.

81Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained40d ago

Install Google Docs MCP server

claude mcp add google-docs -e GOOGLE_DOCS_OAUTH_CLIENT_ID='<google-docs-oauth-client-id>' -e GOOGLE_DOCS_OAUTH_CLIENT_SECRET='<google-docs-oauth-client-secret>' -e GOOGLE_DOCS_OAUTH_REFRESH_TOKEN='<google-docs-oauth-refresh-token>' -e GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY='<google-docs-service-account-private-key>' -- npx -y google-docs-workspace-mcp-server

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": [
        "-y",
        "google-docs-workspace-mcp-server"
      ],
      "env": {
        "GOOGLE_DOCS_OAUTH_CLIENT_ID": "<google-docs-oauth-client-id>",
        "GOOGLE_DOCS_OAUTH_CLIENT_SECRET": "<google-docs-oauth-client-secret>",
        "GOOGLE_DOCS_OAUTH_REFRESH_TOKEN": "<google-docs-oauth-refresh-token>",
        "GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY": "<google-docs-service-account-private-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": [
        "-y",
        "google-docs-workspace-mcp-server"
      ],
      "env": {
        "GOOGLE_DOCS_OAUTH_CLIENT_ID": "<google-docs-oauth-client-id>",
        "GOOGLE_DOCS_OAUTH_CLIENT_SECRET": "<google-docs-oauth-client-secret>",
        "GOOGLE_DOCS_OAUTH_REFRESH_TOKEN": "<google-docs-oauth-refresh-token>",
        "GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY": "<google-docs-service-account-private-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "google-docs": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "google-docs-workspace-mcp-server"
      ],
      "env": {
        "GOOGLE_DOCS_OAUTH_CLIENT_ID": "<google-docs-oauth-client-id>",
        "GOOGLE_DOCS_OAUTH_CLIENT_SECRET": "<google-docs-oauth-client-secret>",
        "GOOGLE_DOCS_OAUTH_REFRESH_TOKEN": "<google-docs-oauth-refresh-token>",
        "GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY": "<google-docs-service-account-private-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "google-docs": {
      "command": "npx",
      "args": [
        "-y",
        "google-docs-workspace-mcp-server"
      ],
      "env": {
        "GOOGLE_DOCS_OAUTH_CLIENT_ID": "<google-docs-oauth-client-id>",
        "GOOGLE_DOCS_OAUTH_CLIENT_SECRET": "<google-docs-oauth-client-secret>",
        "GOOGLE_DOCS_OAUTH_REFRESH_TOKEN": "<google-docs-oauth-refresh-token>",
        "GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY": "<google-docs-service-account-private-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GOOGLE_DOCS_OAUTH_CLIENT_ID	—	yes	OAuth2 client ID from Google Cloud Console.
GOOGLE_DOCS_OAUTH_CLIENT_SECRET	—	yes	OAuth2 client secret from Google Cloud Console.
GOOGLE_DOCS_OAUTH_REFRESH_TOKEN	—	yes	Long-lived refresh token obtained from the oauth-setup command.
GOOGLE_DOCS_SERVICE_ACCOUNT_CLIENT_EMAIL	—	—	Service account email address for domain-wide delegation.
GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY	—	yes	Service account private key in PEM format.
GOOGLE_DOCS_IMPERSONATE_EMAIL	—	—	Email address to impersonate in Google Workspace.
GOOGLE_DOCS_ENABLED_TOOLGROUPS	—	—	Comma-separated list of tool groups to enable (readonly, readwrite, readwrite_external).

Freshness

Maintained — last maintenance signal 40d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-08-30 · 40d ago · GitHub
Latest release
2025-07-03 · 15mo ago · GitHub · monorepo-latest-placeholder@0.0.0
Package published
no data · npm/PyPI
Registry entry updated
2026-06-17 · 4mo ago · official registry · v0.1.4

FAQ

›How do I install the Google Docs MCP server in Claude Code?

Run: claude mcp add google-docs -e GOOGLE_DOCS_OAUTH_CLIENT_ID='<google-docs-oauth-client-id>' -e GOOGLE_DOCS_OAUTH_CLIENT_SECRET='<google-docs-oauth-client-secret>' -e GOOGLE_DOCS_OAUTH_REFRESH_TOKEN='<google-docs-oauth-refresh-token>' -e GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY='<google-docs-service-account-private-key>' -- npx -y google-docs-workspace-mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Google Docs require an API key?

Yes. It expects GOOGLE_DOCS_OAUTH_CLIENT_ID, GOOGLE_DOCS_OAUTH_CLIENT_SECRET, GOOGLE_DOCS_OAUTH_REFRESH_TOKEN, GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY, of which 4 are secrets.

›Can I use Google Docs as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Google Docs in the official MCP registry?

Yes, as com.pulsemcp/google-docs.