Documentation

Expert Documentation

Master Google Apps Script development with Cursor and CLASP

Introduction

Installation

Features

Workflow

Introduction

CLASP Deployer is a high-performance web-based interface designed to bridge the gap between local development in Cursor and the Google Apps Script ecosystem. Powered by Google's CLASP CLI, it offers a seamless workflow for professional developers.

🎯 Core Objectives:

Eliminate the friction of web-based IDEs, enable powerful local refactoring, and provide enterprise-grade version control for Apps Script projects.

System Architecture

The system operates as a local bridge server that orchestrates CLASP commands, manages project metadata, and provides real-time deployment status through this dashboard.

Getting Started

Prerequisites

Before initializing your environment, ensure you have the following components installed:

  • Node.js (LTS Version recommended)
  • Google Account with Apps Script API enabled
  • Cursor IDE for the optimal AI-assisted coding experience

Installation Steps

Global CLI Installation

Execute the following command to install the core deployment engine:

npm install -g @google/clasp
Cloud Authentication

Link your local environment to your Google cloud workspace:

clasp login
Launch Dashboard

Initialize the web management server:

npm start

Integrated Features

Project Matrix

A consolidated view of all active and available Apps Script projects across your account.

Instant Pull

Synchronize cloud scripts to your local Cursor workspace with a single click.

Safe Deploy

Automated push cycles with integrated logging and error detection.

Make.com Sync

Extended support for managing Make.com scenarios alongside your scripts.

Pro Workflow

The Triple-S Cycle

For maximum efficiency, we recommend the Sync-Script-Submit cycle:

  1. Sync: Use the dashboard to pull the latest production code.
  2. Script: Utilize Cursor's AI capabilities to refactor or expand functionality.
  3. Submit: Deploy via the dashboard and monitor the live log output for instant verification.
💡 Pro Tip: Use clasp open from your terminal or the "Open GAS" button in the dashboard to quickly verify UI or Trigger configurations that aren't managed locally.

Troubleshooting

Common Resolutions

Authentication Errors

If you encounter Permission Denied or login loops, reset your credentials:

clasp logout && clasp login

Project Linking

Ensure your .clasp.json file contains the correct scriptId. This file is the primary link between your folder and the cloud script.