whatisgithub

What is clasp?

google/clasp — explained in plain English

Analysis updated 2026-06-26

5,637TypeScriptAudience · developerComplexity · 2/5Setup · easy

In one sentence

Clasp is a command-line tool that lets you write and manage Google Apps Script projects locally in any code editor with Git version control, instead of being stuck in Google's browser-based script editor.

Mindmap

mindmap
  root((repo))
    What it does
      Local script editing
      Apps Script deploy
      Version control
    Workflow
      Login once
      Push code
      Pull changes
    Integrations
      Claude Code MCP
      Gemini CLI MCP
      Google Workspace
    Requirements
      Google account
      Apps Script API
      Node.js
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Write and deploy Google Sheets or Docs automation scripts locally using VS Code instead of the browser editor

USE CASE 2

Store your Google Apps Script project in a Git repository for version control and team collaboration

USE CASE 3

Use clasp as an MCP server inside Claude Code or Gemini CLI to manage Apps Script projects from an AI-assisted workflow

USE CASE 4

Manage multiple deployment versions of an Apps Script and tail live log output from the terminal

What is it built with?

TypeScriptNode.js

How does it compare?

google/claspyeemachine/kalidokitvas3k/taxhacker
Stars5,6375,6385,640
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencedeveloperdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires enabling Google Apps Script API in your Google account settings before first use. TypeScript transpilation must now be handled separately with a bundler in v3.

License not specified in the explanation.

So what is it?

Clasp is a command-line tool that lets you write and manage Google Apps Script projects on your own computer instead of in the browser-based script editor. Google Apps Script is the scripting platform built into Google Workspace products like Sheets, Docs, and Drive. Normally you edit those scripts in a web interface, clasp replaces that with a local workflow where you can use any code editor, store code in version control like Git, and collaborate with other developers. The core workflow is straightforward: you log in once with your Google account, then use clasp to create or clone a script project. From there you write code locally, push changes up to Google's servers with one command, and deploy or run your scripts from the terminal. Clasp also lets you pull down changes, manage multiple deployment versions, and tail live log output from your scripts. File organization is handled automatically. Apps Script stores all files flat in a single project, but clasp converts that into folders when pulling to your local machine, and reconstructs the flat structure when pushing back. This makes it much easier to organize larger projects. Version 3 of the tool dropped built-in TypeScript transpilation. If your project uses TypeScript you now handle that step yourself with a bundler before pushing. The README links to several starter templates that show how to set that up. Some command names also changed between version 2 and 3, and the README includes a migration table. Clasp can also be installed as an extension for Claude Code CLI or Gemini CLI, which makes it available as an MCP server for use in AI-assisted workflows. The tool requires enabling the Google Apps Script API in your Google account settings before first use. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
How do I use clasp to clone an existing Google Sheets Apps Script project to my local machine, edit it in VS Code, and push changes back to Google?
Prompt 2
I want to set up a TypeScript Google Apps Script project with clasp v3. How do I configure a bundler to handle the TypeScript compilation step before pushing?
Prompt 3
How do I use clasp to create multiple deployment versions of my Apps Script and roll back to a previous version if something breaks?
Prompt 4
What changed between clasp v2 and v3? I have an existing project using v2 commands and I need to migrate it to the new command names.
Prompt 5
How do I install clasp as an MCP server extension for Claude Code so I can manage my Google Apps Script projects from within an AI coding session?

Frequently asked questions

What is clasp?

Clasp is a command-line tool that lets you write and manage Google Apps Script projects locally in any code editor with Git version control, instead of being stuck in Google's browser-based script editor.

What language is clasp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js.

What license does clasp use?

License not specified in the explanation.

How hard is clasp to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is clasp for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.