clasp

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.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:

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

• clasp login [--no-localhost] [--creds <file>] [--use-project-scopes] [--include-clasp-scopes] [--extra-scopes <scopes>] [--redirect-port]
• clasp logout
• clasp show-authorized-user [--json]
• clasp create-script [--title <title>] [--type <type>] [--rootDir <dir>] [--parentId <id>]
• clasp clone-script <scriptId | scriptURL> [versionNumber] [--rootDir <dir>]
• clasp delete-script [--force]
• clasp pull [--versionNumber]
• clasp push [--watch] [--force]
• clasp show-file-status [--json]
• clasp open-script
• clasp list-deployments
• clasp create-deployment [--versionNumber <version>] [--description <description>] [--deploymentId <id>]
• clasp delete-deployment [deploymentId] [--all]
• clasp create-version [description]
• clasp list-versions
• clasp list-scripts