Clasp
Note: This is not an officially supported Google product.
<a href="https://coveralls.io/github/google/clasp?branch=master"><img src="https://coveralls.io/repos/github/google/clasp/badge.svg?branch=master" alt="Coverage Status"></a>
<a href="https://www.npmjs.com/package/@google/clasp"><img src="https://img.shields.io/npm/v/@google/clasp.svg" alt="npm Version"></a>
<a href="https://npmcharts.com/compare/@google/clasp?minimal=true"><img src="https://img.shields.io/npm/dw/@google/clasp.svg" alt="npm Downloads"></a>
<a href="https://github.com/google/gts" title="Code Style: Google"><img src="https://img.shields.io/badge/code%20style-google-blueviolet.svg"/></a>
Develop Apps Script projects locally using clasp (Command Line Apps Script Projects).
<!-- GIF bash prompt: PS1='\[\033[38;5;9m\]❤ \[$(tput sgr0)\]' -->
<!-- Width: 888px -->
<!-- Commands:
clasp create "Hello"
ls
echo 'function hello() {
Logger.log("Hello, Apps Script!");
}' >> hello.js
clasp push
clasp deploy
rm .clasp.json appsscript.json hello.js
clear
-->
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