Claude-GAS-Bridge

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows execution of custom Google Apps Script code through a bridge that forwards scripts from an MCP client to a GAS Interpreter endpoint, enabling AI agents to run custom scripts in the Google Apps Script environment.

Claude-GAS-Bridge

Node.js를 사용하여 MCP(Model Context Protocol) 클라이언트(예: Claude Desktop)와 GAS Interpreter(Google Apps Script 측)를 연결하는 브리지 서버입니다.
bridge.mjs 내에서 @modelcontextprotocol/sdk MCP 서버를 시작하고 GAS 웹 엔드포인트로 HTTP POST하는 기능을 제공합니다.

구성 개요

claude-gas-bridge/ ├─ bridge.mjs # メインのMCPサーバーコード ├─ package.json ├─ package-lock.json └─ ... (その他ファイル)
  • bridge.mjs
    MCP 서버 본체. execute-gas 라는 도구를 정의하고 클라이언트에서받은 GAS 스크립트를 지정된 WebApp (Apps Script) 끝점으로 전송합니다.
    툴 호출시, 타이틀·스크립트 본문·API 키를 JSON 로 송신하는 형태입니다.

필요한 환경

  • Node.js 18 이상
    @modelcontextprotocol/sdk 는 Node 18 이상을 권장합니다.
  • GAS Interpreter 배포됨
    Google Apps Script에서 GAS Interpreter를 올바르게 배포하고 웹 앱 URL을 얻습니다.
  • (선택 사항) Claude Desktop과 같은 MCP 클라이언트

설정

  1. 소스 얻기
    git clone <このリポジトリのURL> cd claude-gas-bridge
  2. 종속 패키지 설치
    npm install
    ※ Yarn에서도 가능
  3. GAS 배포 URL 설정
    bridge.mjsGAS_ENDPOINT 를 실제 Apps Script URL로 다시 씁니다.
    예:
    const GAS_ENDPOINT = "https://script.google.com/macros/s/AKfycbxxxxx/exec";
  4. Node.js로 서버 시작
    node bridge.mjs
    콘솔에 "Bridge server started (Stdio). Waiting for requests..." 가 되고 MCP 클라이언트로부터의 호출을 수락합니다.

Claude Desktop과의 협력(예)

Claude Desktop에서 사용하는 경우 claude_desktop_config.json 다음과 같이 설정하십시오.

{ "mcpServers": { "gas-bridge": { "command": "node", "args": [ "/絶対パス/claude-gas-bridge/bridge.mjs" ] } } }
  1. Claude Desktop 다시 시작
  2. 채팅 화면 하단의 도구 목록(해머 아이콘)에서 execute-gas 볼 수 있어야 합니다.
  3. "ChatGPT를 통해 GAS 스크립트를 실행하고 싶다"와 같은 지시를 받으면 bridge.mjs 가 요청을 받고 GAS Interpreter로 전달합니다.

API 키 관리 정보

  • GAS Interpreter 측이 API 키를 요구하는 경우는, 툴 호출시에 "apiKey": "..." 를 지정하는지, bridge.mjs 내부에서 환경 변수를 참조해 포함하는 등 적절하게 조정해 주세요.

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

A bridge server that connects MCP clients (like Claude Desktop) to Google Apps Script, allowing execution of GAS scripts through natural language interfaces.

  1. 構成概要
    1. 必要環境
      1. セットアップ
        1. Claude Desktop との連携 (例)
          1. APIキーの管理について
            ID: mfqd2f9akw