Clasp
Note: This is not an officially supported Google product.
Develop Apps Script projects locally using clasp (Command Line Apps Script Projects).
To get started, try out the codelab!
You can also try clasp in Gitpod, a one-click online IDE for GitHub:
Features
🗺️ Develop Locally: clasp allows you to develop your Apps Script projects locally. That means you can check-in your code into source control, collaborate with other developers, and use your favorite tools to develop Apps Script.
🔢 Manage Deployment Versions: Create, update, and view your multiple deployments of your project.
📁 Structure Code: clasp automatically converts your flat project on script.google.com into folders. For example:
- On script.google.com:
tests/slides.gstests/sheets.gs
- locally:
➡️ Run Apps Script: Execute your Apps Script from the command line. Features:
- Instant deployment.
- Suggested functions Autocomplete (Fuzzy)
- Easily add custom Google OAuth scopes
- And more…
Install
First download clasp:
npm install -g @google/clasp
Then enable the Google Apps Script API: https://script.google.com/home/usersettings
Installing as a Gemini CLI Extension
You can install clasp as an Gemini CLI extensions using the following command:
gemini extensions install https://github.com/google/clasp
This makes clasp available as an MCP server in Gemini CLI.
Make sure to enable the Google Apps Script API (as explained above) and perform a clasp login (with your specific login parameters) before you use the extension.
Installing as a Claude Code CLI Extension
You can use clasp with Claude Code CLI in one of two ways:
1. Install as a Plugin (Recommended)
Run the following command in Claude Code to install clasp as a plugin directly from the repository:
/plugin install @google/clasp
2. Manual Installation
You can manually add clasp as an MCP server using the provided configuration file or by running:
claude mcp add clasp -- npx -y @google/clasp mcp
Or by referencing the configuration file included in the repository:
claude mcp add-json clasp "$(cat claude-mcp.json)"
Commands
The following command provide basic Apps Script project management.
Note: Most of them require you to clasp login and clasp create/clone before using the rest of the commands.
clasp
