Gas

You can run the MCP GAS Server locally to develop Google Apps Script projects with full CommonJS modules, bidirectional sync, and an AI-driven workflow. This setup lets you write GAS code locally, manage dependencies, and deploy or test your scripts directly from your development environment.

How to use

You connect an MCP client to the local GAS server and use familiar commands to manage your GAS project. The server runs as a local process and exposes standard MCP tools for file operations, code execution, Git integration, and deployment workflows. Write modular GAS code, use require() for dependencies, run ad-hoc JavaScript expressions, and promote changes through a production workflow. You can integrate with AI assistants to generate, modify, and test GAS projects end-to-end.

How to install

Prerequisites include Node.js and npm, plus a Google account for GAS access. You will also need an AI assistant that can issue commands to the MCP server.

# 1) Install dependencies and prepare the server (example start)
# Fully automated installer (recommended) is available via a single command
curl -fsSL https://raw.githubusercontent.com/whichguy/mcp_gas/main/install.sh | bash -s -- --auto

# Alternatively, manual setup
git clone https://github.com/whichguy/mcp_gas.git && cd mcp_gas && ./install.sh

Additional setup and configuration

One-time configuration is required to enable Google Apps Script API access and OAuth credentials. You will create or select a Google Cloud project, enable the Google Apps Script API, and download OAuth credentials as oauth-config.json, placing it in the project root. You will also configure your IDEs or MCP clients to launch the local server using the runtime command shown below.

Configuring the local MCP server (stdio mode)

The server runs locally and is started via a Node command that points to the compiled server entry in dist/.

{
  "mcpServers": {
    "gas": {
      "type": "stdio",
      "name": "gas",
      "command": "node",
      "args": ["/absolute/path/to/mcp_gas/dist/src/index.js"],
      "env": {"NODE_ENV": "production"}
    }
  }
}

Available tools

mcp_gas__auth

Authenticate with Google and start the GAS server session.

mcp_gas__project_create

Create a new Google Apps Script project within GAS server.

mcp_gas__project_list

List existing GAS projects managed by the MCP server.

mcp_gas__write

Write or update a GAS script file, with automatic CommonJS wrapping when using smart tools.

mcp_gas__cat

Read file contents from a GAS project, returning user-written code without internal wrappers.

mcp_gas__ls

List files and directories in a GAS project workspace.

mcp_gas__run

Execute ad-hoc JavaScript expressions or GAS functions within a project.

mcp_gas__rsync

Two-phase synchronization between local workspace and GAS cloud storage (plan then execute).

mcp_gas__config

Configure synchronization or other server settings for your GAS project.

mcp_gas__git_feature

Manage feature branches for GAS project code in Git.

mcp_gas__deploy

Promote code changes through dev, staging, and prod deployments.

mcp_gas__project_set

Set the current GAS project context for subsequent commands.

mcp_gas__ripgrep

Perform fast, multi-pattern searches in GAS project files; preferred over grep.

mcp_gas__grep

Search for text patterns in GAS project files.

mcp_gas__find

Find files by name or pattern within the GAS project.

mcp_gas__sed

Find-and-replace text in GAS project files.

mcp_gas__upload

Upload local changes to the GAS cloud storage.

mcp_gas__download

Download GAS project files from the cloud to your local workspace.

mcp_gas__auth

Authentication helper to obtain OAuth tokens for GAS access.

mcp_gas__project_create

Create a new GAS project and wire initial code structure.