Google Apps Script MCP Setup & Guide
io.github.A1-x-Tech/mcp-google-apps-script · v1.0.0
MCP server for the Google Apps Script API: projects, code, versions, deployments and executions.
Copy the install config on this page first, then verify docs and permissions upstream.
Overview
MCP server for the Google Apps Script API: projects, code, versions, deployments and executions. Google Apps Script MCP is a MCP Server listed from MCP Registry. Transports: stdio. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.
Use cases
AgentHub Verified AvailabilityTested & Ready
Automated pipeline validated install commands, protocol & client compatibility
Copy by platform
Choose your platform
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
Pre-fill Environment Variables (Optional)
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}Setup tutorial
- Open the Google Apps Script MCP page and confirm this MCP Server (source: MCP Registry).
- Copy the Cursor, Claude Code, or VS Code snippet.
- Merge it into mcpServers and replace env placeholders with real secrets.
- Reload the window, then call the MCP tools from your agent chat.
Install commands
Install commands and setup steps are in the HTML so search engines and no-JS browsers can read them without running client JavaScript.
Claude Code (local)
- Install Claude Code CLI
- Copy the command below, replace <placeholders> with real env values, then run in terminal
- See Environment variables below if listed
claude mcp add mcp-google-apps-script -- npx -y mcp-google-apps-scriptCursor — .cursor/mcp.json (local)
- Open or create .cursor/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets (see Environment variables below)
- Save, then Cmd+Shift+P → Reload Window
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}VS Code — .vscode/mcp.json (local)
- Install GitHub Copilot in VS Code with MCP support
- Open or create .vscode/mcp.json in your project root
- Click Copy config and paste; merge only this mcpServers entry if others exist
- Replace <placeholders> in env with real secrets
- Save and Developer: Reload Window
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}Claude Desktop — claude_desktop_config.json (local)
- Open Claude Desktop claude_desktop_config.json (see remote guide for paths)
- Click Copy config and merge under mcpServers
- Replace <placeholders> in env with real secrets
- Fully quit and restart Claude Desktop
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}Trae — .trae/mcp.json (local)
- Trae → Settings → MCP, or edit .trae/mcp.json / global mcp.json
- Click Copy config and merge mcpServers
- Replace <placeholders> in env with real secrets
- Save and reload Trae
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}Cherry Studio — MCP settings (local)
- Cherry Studio → Settings → MCP Servers → Add (STDIO)
- Or import JSON: click Copy config and merge mcpServers
- Replace <placeholders> in env; ensure Node.js / uv (npx, uvx) are installed
- Enable the server and check tools load
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}Tongyi Lingma — MCP config (local)
- Lingma Settings → MCP → + → STDIO or config file
- Click Copy config and merge mcpServers
- Replace <placeholders> in env; need Node.js 18+ (npx) or uv (uvx)
- Confirm connected before using tools in agent chat
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}Windsurf — mcp_config.json (local)
- Edit ~/.codeium/windsurf/mcp_config.json
- Click Copy config and merge mcpServers (stdio same as Cursor)
- Replace <placeholders> in env, save, refresh Cascade
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}Cline — MCP Servers (local)
- Cline panel → Settings → MCP Servers
- Click Copy config and merge
- Replace <placeholders> in env, then save
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}WorkBuddy — .workbuddy/mcp.json (local)
- Edit ~/.workbuddy/mcp.json (user) or project .workbuddy/mcp.json
- Or Plugins → MCP Servers → Configure MCP and paste the JSON below
- Replace <placeholders> in env; on Windows prefer absolute paths for command/scripts
- Save, restart WorkBuddy, confirm connector status is green
{
"mcpServers": {
"mcp-google-apps-script": {
"command": "npx",
"args": [
"-y",
"mcp-google-apps-script"
]
}
}
}Troubleshooting & Common ErrorsFAQ
Common connection errors and verified fixes for Google Apps Script MCP
Getting 'connection closed' or exit code 1 in Cursor / Claude Code for Google Apps Script MCP?
Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.
# Check binary path in terminal: which npx node -v
Getting 'spawn npx ENOENT' or 'command not found'?
The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).
Missing required environment variable or authentication failure?
Google Apps Script MCP requires environment variables (GOOGLE_APPS_SCRIPT_CLIENT_ID、GOOGLE_APPS_SCRIPT_CLIENT_SECRET、GOOGLE_APPS_SCRIPT_REFRESH_TOKEN、GOOGLE_APPS_SCRIPT_ACCESS_TOKEN、GOOGLE_APPS_SCRIPT_OAUTH_PORT、GOOGLE_APPS_SCRIPT_API_BASE、GOOGLE_APPS_SCRIPT_TIMEOUT_MS、GOOGLE_APPS_SCRIPT_MAX_RETRIES). Ensure you have added valid keys under the 'env' object in your config file without trailing whitespace.
// .cursor/mcp.json 或 claude_desktop_config.json
{
"env": {
"API_KEY": "your_actual_key_here"
}
}Tool Mock Playground
SandboxGoogle Apps Script MCP Tool Interface Simulation · Preview tool schema & outputs without local runtime
{
"target": "Google Apps Script MCP",
"action": "execute",
"options": {
"mode": "standard",
"timeoutMs": 5000
}
}Click 'Run Mock' above
to preview the raw response returned to the LLM
Decision Guide: Why & When to Use
Assess suitability before installing to save trial-and-error time
- PR review
- Changelog generation
- Cross-repo issue search
- Replacing human security audit
- Unauthorized repo access
Google Apps Script MCP + Scenario Prompt → Complete Agent Automation
MCP hands-on: install to visible results
Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.
Related resources
Remembra Relay
v0.17.4
io.github.remembra-ai/remembra
Cross-agent handoff: the next coding agent starts from the last one's facts, not a blank page.
mtg-mcp
v0.10.0
io.github.nccurry/mtg-mcp
An evidence-first .NET MCP server for Magic: The Gathering deckbuilding workflows.
sdcreceipt
v4.3.2
io.github.SemanticDataCharter/sdcreceipt
Verify and settle VSL Settlement Receipts. Verification needs no network and no account.
NexusWindows for Claude
v3.2.1
io.github.pironjulien/nexus-windows-claude
Windows computer use in the background: UI Automation and Win32 messages, every action read back.
sdcreader
v4.4.1
io.github.SemanticDataCharter/sdcreader
Read published Semantic Data Charter models: catalog search, record structure, codes, pinned schema.
Google News & Trends MCP
v0.2.43
io.github.AKzar1el/mcp-trendpulse
Query Google News RSS feeds and search interest over time via Google Trends.
Often paired with
中文公文写作
v2.0.41
io.clawhub.gongyu0918-debug/chinese-official-writing
用于中文公文、事务性材料和新闻稿件的起草、改写、压缩、润色、审校、文种核对、去口语化、降 AI 味及 Word 格式处理，适用于机关、企事业单位、学校和新闻机构。涵盖申请、请示、报告、通知、通告、意见、决定、决议、议案、公报、命令、函、复函、批复、说明、方案、纪要、公告、公示、通报、制度、规定、办法、细则、操作规程、工作要点、总结、调研、讲话、致辞、主持词、述职、可研、审查材料、技术需求、新闻消息、编者按、新闻评论，以及采购、整改、反馈和 AI 算力等场景。
Planning with files
v3.25.0
io.clawhub.othmanadi/planning-with-files
Persistent file-based planning for multi-step AI-agent work. Keeps task_plan.md, findings.md, and progress.md on disk; lifecycle hooks inject selected project planning context. Automatic recovery reads project planning files only. Explicit session-catchup.py --metadata reads same-project local agent session records and emits aggregate counts only; --replay may emit bounded nonce-framed excerpts. Optional gated mode can request continuation only when the host supports it and never runs commands declared in Markdown. The skill has no network upload path. Use for research or work needing 5+ tool calls.
canonry
v7.50.1+a36190c
io.clawhub.arberx/canonry
Navigate Canonry through connected MCP tools or the `cnry` CLI to inspect evidence, diagnose changes, plan measurement, review integrations, and report results. Use this optional host-native skill for CLI workflows and detailed references; connected MCP users can operate through canonry_help without installing a local runtime or skill.
gitlab-cli-skills
v1.13.33
io.clawhub.vince-winkintel/gitlab-cli-skills
Comprehensive GitLab CLI (glab) command reference and workflows for all GitLab operations. Use when working with merge requests, CI/CD pipelines, issues, releases, repositories, authentication, variables, labels, milestones, snippets, or any glab command. Covers 40+ sub-commands including glab mr, glab ci, glab issue, glab repo, glab release, glab variable, and more.
Keep exploring AgentHub
Most people compare similar tools or check scenario guides before installing—start here.
Listing badge: put AgentHub on your site
Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.
<a href="https://myagenthub.cn/p/io.github.A1-x-Tech/mcp-google-apps-script" title="Listed on AgentHub: Google Apps Script MCP" target="_blank" rel="noopener">
<img src="https://myagenthub.cn/badge/io.github.A1-x-Tech/mcp-google-apps-script?lang=en" alt="Listed on AgentHub: Google Apps Script MCP" height="20" style="border:0"/>
</a>[](https://myagenthub.cn/p/io.github.A1-x-Tech/mcp-google-apps-script)Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.
Unified Manifest
{
"id": "io.github.A1-x-Tech/mcp-google-apps-script",
"type": "mcp-server",
"version": "1.0.0",
"displayName": "Google Apps Script MCP",
"description": "MCP server for the Google Apps Script API: projects, code, versions, deployments and executions.",
"repository": {
"url": "https://github.com/A1-x-Tech/mcp-google-apps-script",
"source": "github"
},
"homepage": "https://github.com/A1-x-Tech/mcp-google-apps-script#readme",
"distribution": {
"packages": [
{
"registryType": "npm",
"identifier": "mcp-google-apps-script",
"version": "1.0.0",
"transport": "stdio",
"environmentVariables": [
{
"name": "GOOGLE_APPS_SCRIPT_CLIENT_ID",
"description": "Google OAuth2 client id (refresh-token flow)."
},
{
"name": "GOOGLE_APPS_SCRIPT_CLIENT_SECRET",
"description": "Google OAuth2 client secret (refresh-token flow). Treat it as a secret.",
"isSecret": true
},
{
"name": "GOOGLE_APPS_SCRIPT_REFRESH_TOKEN",
"description": "Google OAuth2 refresh token, exchanged for access tokens automatically. Treat it as a secret.",
"isSecret": true
},
{
"name": "GOOGLE_APPS_SCRIPT_ACCESS_TOKEN",
"description": "Static OAuth2 access token (~1h lifetime) — alternative to the refresh-token trio, mostly for testing.",
"isSecret": true
},
{
"name": "GOOGLE_APPS_SCRIPT_OAUTH_PORT",
"description": "Fixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login."
},
{
"name": "GOOGLE_APPS_SCRIPT_API_BASE",
"description": "API root override."
},
{
"name": "GOOGLE_APPS_SCRIPT_TIMEOUT_MS",
"description": "Per-request timeout in milliseconds."
},
{
"name": "GOOGLE_APPS_SCRIPT_MAX_RETRIES",
"description": "Retries on transient errors (429 always; 5xx/network for reads)."
}
]
}
],
"remotes": []
},
"dependencies": [],
"installTargets": [
"claude-code",
"claude-desktop",
"cursor",
"vscode",
"trae",
"cherry-studio",
"lingma",
"windsurf",
"cline",
"workbuddy"
],
"keywords": [],
"provenance": {
"origin": "official-mcp-registry",
"originalId": "io.github.A1-x-Tech/mcp-google-apps-script",
"originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.A1-x-Tech%2Fmcp-google-apps-script/versions/latest",
"isOfficial": true,
"status": "active"
}
}