+0
Daily
5,910
stars
523
forks
66
watchers
578
prs
596
issues
31
releases
README
Clasp
Note: This is not an officially supported Google product.
!build status
Develop Apps Script projects locally using clasp (Command Line Apps Script Projects).
hello.js
clasp push
clasp deploy
rm .clasp.json appsscript.json hello.js
clear
--
!clasp
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.gs
- tests/sheets.gs
- _locally_:
- tests/
- slides.js
- sheets.js
➡️ 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:
sh
npm install -g @google/clasp
Then enable the Google Apps Script API: https://script.google.com/home/usersettings
!Enable Apps Script API
Installing as a Gemini CLI Extension
You can install clasp as an Gemini CLI extensions using the following command:
sh
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:
sh
/plugin install @google/clasp
2. Manual Installation
You can manually add clasp as an MCP server using the provided configuration file or by running:
sh
claude mcp add clasp -- npx -y @google/clasp mcp
Or by referencing the configuration file included in the repository:
sh
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.
sh
clasp
- [clasp login [--no-localhost] [--creds ] [--use-project-scopes] [--include-clasp-scopes] [--extra-scopes ] [--redirect-port]](login)
- clasp logout
- [clasp show-authorized-user [--json]](show-authorized-user)
- [clasp create-script [--title ] [--type ] [--rootDir ] [--parentId ]](create)
- [clasp clone-script [versionNumber] [--rootDir ]](clone)
- [clasp delete-script [--force]](delete)
- [clasp pull [--versionNumber]](pull)
- [clasp push [--watch] [--force]](push)
- [claspTop issues
#63Clasp deploy doesn't update the deployed version with Google Apps Script Web App43 comments · 2018-03-12#224Can't delete versions19 comments · 2018-06-20#989[RFC] Multiple (private) GAS targets: remotes10 comments · 2023-11-13#950Feat : clasp login with service account9 comments · 2022-11-24#353clasp metrics9 comments · 2018-10-18#1051Can't push scripts by service account8 comments · 2025-04-11#178Selective file push and pull8 comments · 2018-05-21#917Error retrieving access token: TypeError: Cannot destructure property 'client_id' of 'options.creds.installed' as it is undefined.7 comments · 2022-04-05
Discussions
#1134How to change the order of files with `clasp`0 comments · 2026-03-17#1016Current version of chokiadr uses vulnerable version of braces 3.0.2.Do we have any plans to update this?0 comments · 2024-08-28#1014How can i create a new version without creating a new deployment?1 comments · 2024-07-27#1010clasp pull behaviour changed?1 comments · 2024-05-31#1006I want to Test Deploy after `clasp push`3 comments · 2024-03-21#1005Some types are shown as unresolved in my GAS project unexpectedly1 comments · 2024-03-20#980Clasp 3.x roadmap5 comments · 2023-10-12
Latest release
v3.4.1 clasp-v3.4.1 2026-08-283.4.1 (2026-08-28) Bug Fixes files: prevent rootDir double application during pull, clone, and create (13d3322)