Terra Mcp Google

БесплатноНе проверен

Kozocom MCP server

Описание

Kozocom MCP server

README

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, …)

from github.com/quangtd-kozocom/terra-mcp-google

Установить Terra Mcp Google в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install terra-mcp-google

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add terra-mcp-google -- npx -y terra-mcp-google

FAQ

Terra Mcp Google MCP бесплатный?

Да, Terra Mcp Google MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Terra Mcp Google?

Нет, Terra Mcp Google работает без API-ключей и переменных окружения.

Terra Mcp Google — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Terra Mcp Google в Claude Desktop, Claude Code или Cursor?

Открой Terra Mcp Google на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Compare Terra Mcp Google with

Terra Mcp GooglevsGitHub Terra Mcp GooglevsFilesystem Terra Mcp GooglevsMemory Terra Mcp GooglevsTemplate MCP Server

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development

Command Palette