Google Apps Script MCP Server

The escape hatch: write, deploy, and execute custom code across Workspace.

$ uvx workspace-mcp --tools appscript runs only the Google Apps Script MCP tools — combine services as needed

Apps Script is the escape hatch for everything the other eleven services don’t cover. An assistant can create a script project, write or update its source with update_script_content, and execute deployed functions with arguments via run_script_function — custom automation authored and invoked in the same conversation.

The operational tools matter just as much: list_deployments and manage_deployment handle versioning, and list_script_processes shows recent executions and their status when something needs debugging.

What you can ask

  • “Write a script that snapshots the on-call sheet every Friday and deploy it”
  • “Run the syncInventory function against the staging spreadsheet”
  • “Which script executions failed this week, and why?”

All 9 Google Apps Script MCP tools

Tiers control how many tools the server registers: start lean with --tool-tier core and step up to extended or complete when a workflow needs more. Parameters and examples for every tool are in the API reference.

list_script_projects Core List available script projects.
get_script_project Core Retrieve full project structure and files.
get_script_content Core Read a script file from a project.
create_script_project Core Create standalone or bound script projects.
update_script_content Core Create or update script files.
run_script_function Core Execute deployed script functions with args.
list_deployments Extended List deployments for a project.
manage_deployment Extended Create, update, or delete deployments.
list_script_processes Extended Inspect recent executions and status.

OAuth scopes

The server requests only the scopes for the services you enable. In read-only mode it requests just the readonly variants and skips registering write tools entirely.

  • script.projects create and edit script projects
  • script.deployments manage deployments and versions
  • script.processes inspect executions and status

Google Apps Script MCP questions

Can an assistant write a script and run it in the same session?
Yes, with one Apps Script platform caveat: run_script_function executes functions from a deployed script, so the flow is create or update the source, create a deployment with manage_deployment, then invoke. All three steps are tool calls the assistant can chain.
What are bound scripts, and are they supported?
create_script_project creates both standalone projects and scripts bound to a specific Doc, Sheet, or Form — bound scripts are how you add custom behavior to one particular document.
When should I reach for Apps Script instead of a native service?
When the other services don’t expose what you need: custom triggers, Workspace APIs the server doesn’t wrap, or multi-step server-side logic that should run on Google’s infrastructure rather than through a dozen round trips.