MCP server for Google Docs integration with OAuth2 and service account support.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add google-docs --env GOOGLE_DOCS_OAUTH_CLIENT_ID='<GOOGLE_DOCS_OAUTH_CLIENT_ID>' --env GOOGLE_DOCS_OAUTH_CLIENT_SECRET='<GOOGLE_DOCS_OAUTH_CLIENT_SECRET>' --env GOOGLE_DOCS_OAUTH_REFRESH_TOKEN='<GOOGLE_DOCS_OAUTH_REFRESH_TOKEN>' --env GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY='<GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY>' -- npx -y google-docs-workspace-mcp-server~/.codex/config.toml
[mcp_servers.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>" }
# codex mcp add google-docs --env GOOGLE_DOCS_OAUTH_CLIENT_ID='<GOOGLE_DOCS_OAUTH_CLIENT_ID>' --env GOOGLE_DOCS_OAUTH_CLIENT_SECRET='<GOOGLE_DOCS_OAUTH_CLIENT_SECRET>' --env GOOGLE_DOCS_OAUTH_REFRESH_TOKEN='<GOOGLE_DOCS_OAUTH_REFRESH_TOKEN>' --env GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY='<GOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY>' -- npx -y google-docs-workspace-mcp-server~/.cursor/mcp.json
{
"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>"
}
}
}
}.vscode/mcp.json
{
"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>"
}
}
}
}~/.gemini/settings.json
{
"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>"
}
}
}
}claude_desktop_config.json
{
"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>"
}
}
}
}.trae/mcp.json
{
"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>"
}
}
}
}Environment variables
GOOGLE_DOCS_OAUTH_CLIENT_IDGOOGLE_DOCS_OAUTH_CLIENT_SECRETGOOGLE_DOCS_OAUTH_REFRESH_TOKENGOOGLE_DOCS_SERVICE_ACCOUNT_PRIVATE_KEY
Replace the placeholders with your own credentials and keep them out of version control.