Terra MCP Google

GitHub Actions

Kozocom MCP server

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "terra-mcp-google": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add terra-mcp-google -- npx -y terra-mcp-google@0.1.20

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "terra-mcp-google": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.20
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Terra MCP Google?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Terra MCP Google need an API key?

No required environment variable is listed on this record.

What transport does Terra MCP Google use?

Terra MCP Google runs locally over stdio.

When was Terra MCP Google last checked?

Last checked 2026-10-28. Kozocom MCP server

From the publisher

Documentation

terra-mcp — Google Drive + Sheets MCP server

Read/write access to your Google Drive and Sheets. OAuth + PKCE login — only the public client ID ships in npm, consent happens in browser, token is cached and auto-refreshed.

Quick start

npm install -g terra-mcp-google
terra-mcp auth login          # browser consent, caches token
terra-mcp client codex        # print safe (read-only) MCP config
npx skills add quangtd-kozocom/terra-mcp-google   # install the agent skill

CLI

Command	Does
`auth login` / `logout` / `status`	sign in / out / show account, scopes, expiry
`setup`	check config dir + auth, print MCP config for all clients
`client [codex\|claude\|copilot\|kiro\|all]`	print MCP config with mutating tools disabled (`--include-dangerous` keeps them)
`admin`	open the web console to manage which resources the agent may access (`-p` port, `--no-open`)
(no command)	start the stdio server

Configuration

Set these in your MCP client's env block (or the launching shell):

Variable	Default	Purpose
`TERRA_MCP_DIR`	`~/.terra-mcp`	Directory holding the OAuth client config + cached token
`GOOGLE_OAUTH_TOKEN`	`<TERRA_MCP_DIR>/token.json`	Cached access/refresh token
`TERRA_MCP_SAFE_MODE`	unset	`1` → register only read-only tools; drop every mutating tool
`TERRA_MCP_POLICY_DB`	`<TERRA_MCP_DIR>/policy.db`	SQLite database holding the resource allowlist + policy mode
`TERRA_MCP_POLICY_MODE`	`read_open`	Initial mode before one is chosen in the console: `off` \| `read_open` \| `strict`
`TERRA_MCP_ADMIN_PORT`	`4717`	Port the `admin` web console listens on

Permission gate (per-resource allowlist)

Beyond on/off tool gating, you can allowlist exactly which Drive files/folders the agent may touch, and with what power (read / write / delete). Every call is checked against a small local SQLite allowlist first; created resources are auto-added. Manage it in the web console:

terra-mcp admin        # web console at http://localhost:4717

Three modes (switch any time): off — gate disabled; read_open (default) — read/create anything, but write/delete only granted resources; strict — only granted resources are visible at all (even to list/search). New grants default to read-only; a folder grant cascades to its contents. Console and server share the DB, so changes apply on the next call — no restart.

Requires Node 23.4+ (or Node 22.5+ with --experimental-sqlite). On older Node the server still runs with the gate disabled.

Tools

Auth — sign-in/out are CLI-only (terra-mcp auth login/logout).

Tool	Does
`google_auth_status`	show signed-in account, granted scopes, token expiry

Drive

Tool	Does
`drive_list_files`	list / search files (Drive `q` query, pagination)
`drive_get_file`	get file metadata by ID
`drive_download_file`	download or export content (Google-native files → csv/txt/pdf/…)
`drive_create_folder`	create a folder
`drive_upload_file`	upload inline text or a local file
`drive_update_file`	rename, move, or replace content
`drive_copy_file`	duplicate a file
`drive_delete_file`	trash (default) or permanently delete

Sheets

Tool	Does
`sheets_create_spreadsheet`	create a spreadsheet
`sheets_get_spreadsheet`	list tabs and their dimensions
`sheets_read_range`	read one A1 range, or many at once (pass an array of ranges)
`sheets_write_range`	overwrite values in one A1 range, or many at once (pass `data`)
`sheets_append_rows`	append rows after the last row of a table
`sheets_clear_range`	clear values in a range
`sheets_add_sheet` / `sheets_delete_sheet`	add / remove a tab
`sheets_format_cells`	format a cell range (colors, bold, font size, alignment)
`sheets_set_data_validation`	set a dropdown (list) rule on a range
`sheets_batch_update`	escape hatch: raw `spreadsheets.batchUpdate` requests (merge, borders, sort, …)

Terra MCP Google

GitHub Actions

Kozocom MCP server

Devops Developer Tools

Add to Cursor Add to VS Code Run on PlugMCP

GitHub npm Website

Add to Cursor Add to VS Code Run on PlugMCP

1{2  "mcpServers": {3    "terra-mcp-google": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

.cursor/mcp.jsonMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add terra-mcp-google -- npx -y terra-mcp-google@0.1.20

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "terra-mcp-google": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.20
Last checked: 2026-10-28

Stars: —
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Terra MCP Google?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Terra MCP Google need an API key?

No required environment variable is listed on this record.

What transport does Terra MCP Google use?

Terra MCP Google runs locally over stdio.

When was Terra MCP Google last checked?

Last checked 2026-10-28. Kozocom MCP server

From the publisher

Documentation

terra-mcp — Google Drive + Sheets MCP server

Read/write access to your Google Drive and Sheets. OAuth + PKCE login — only the public client ID ships in npm, consent happens in browser, token is cached and auto-refreshed.

Quick start

npm install -g terra-mcp-google
terra-mcp auth login          # browser consent, caches token
terra-mcp client codex        # print safe (read-only) MCP config
npx skills add quangtd-kozocom/terra-mcp-google   # install the agent skill

CLI

Command	Does
`auth login` / `logout` / `status`	sign in / out / show account, scopes, expiry
`setup`	check config dir + auth, print MCP config for all clients
`client [codex\|claude\|copilot\|kiro\|all]`	print MCP config with mutating tools disabled (`--include-dangerous` keeps them)
`admin`	open the web console to manage which resources the agent may access (`-p` port, `--no-open`)
(no command)	start the stdio server

Configuration

Set these in your MCP client's env block (or the launching shell):

Variable	Default	Purpose
`TERRA_MCP_DIR`	`~/.terra-mcp`	Directory holding the OAuth client config + cached token
`GOOGLE_OAUTH_TOKEN`	`<TERRA_MCP_DIR>/token.json`	Cached access/refresh token
`TERRA_MCP_SAFE_MODE`	unset	`1` → register only read-only tools; drop every mutating tool
`TERRA_MCP_POLICY_DB`	`<TERRA_MCP_DIR>/policy.db`	SQLite database holding the resource allowlist + policy mode
`TERRA_MCP_POLICY_MODE`	`read_open`	Initial mode before one is chosen in the console: `off` \| `read_open` \| `strict`
`TERRA_MCP_ADMIN_PORT`	`4717`	Port the `admin` web console listens on

Permission gate (per-resource allowlist)

terra-mcp admin        # web console at http://localhost:4717

Requires Node 23.4+ (or Node 22.5+ with --experimental-sqlite). On older Node the server still runs with the gate disabled.

Tools

Auth — sign-in/out are CLI-only (terra-mcp auth login/logout).

Tool	Does
`google_auth_status`	show signed-in account, granted scopes, token expiry

Drive

Tool	Does
`drive_list_files`	list / search files (Drive `q` query, pagination)
`drive_get_file`	get file metadata by ID
`drive_download_file`	download or export content (Google-native files → csv/txt/pdf/…)
`drive_create_folder`	create a folder
`drive_upload_file`	upload inline text or a local file
`drive_update_file`	rename, move, or replace content
`drive_copy_file`	duplicate a file
`drive_delete_file`	trash (default) or permanently delete

Sheets

Tool	Does
`sheets_create_spreadsheet`	create a spreadsheet
`sheets_get_spreadsheet`	list tabs and their dimensions
`sheets_read_range`	read one A1 range, or many at once (pass an array of ranges)
`sheets_write_range`	overwrite values in one A1 range, or many at once (pass `data`)
`sheets_append_rows`	append rows after the last row of a table
`sheets_clear_range`	clear values in a range
`sheets_add_sheet` / `sheets_delete_sheet`	add / remove a tab
`sheets_format_cells`	format a cell range (colors, bold, font size, alignment)
`sheets_set_data_validation`	set a dropdown (list) rule on a range
`sheets_batch_update`	escape hatch: raw `spreadsheets.batchUpdate` requests (merge, borders, sort, …)