ClickUp MCP Bridge for Antigravity

A robust, platform-independent Model Context Protocol (MCP) bridge connecting Google Antigravity IDE (Gemini Code Assist) with ClickUp on Windows, macOS, and Linux.

🚀 Why This Exists

Windows process managers often fail to spawn command-based MCP servers (like .cmd or .ps1 scripts) directly without a shell.

This bridge runs a direct, lightweight Node client wrapper (clickup-mcp.js) to invoke the global mcp-remote proxy natively using node.exe, completely bypassing Windows process spawning restrictions.

✨ Features

• 📂 Auto-Resolution: Automatically maps your current workspace folder name to ClickUp list IDs using project config aliases.
• 🔐 Interactive OAuth: Automatically detects the ClickUp login URL and opens it in your default web browser.
• 🗺️ Remote Space Sync: Syncs and browses your ClickUp spaces, folders, and lists directly from the CLI.
• ⚡ No Local node_modules: Built entirely using Node.js standard libraries inside the plugin, requiring only the global mcp-remote package as an external dependency.

📦 Installation & Setup

Method A: Agent-Led (Recommended)

1. Copy the Plugin Folder: Copy this repository folder into your global Antigravity plugins directory:

   • Windows: C:\Users\<Name>\.gemini\config\plugins\clickup-mcp-plugin
   • macOS / Linux: ~/.gemini/config/plugins/clickup-mcp-plugin

2. Trigger Setup in Chat: Open your Antigravity IDE and type:

   "Set up ClickUp for me"

3. The agent will automatically check prerequisites, run the OAuth login, and map your workspace folders.

Method B: Manual CLI Setup

1. Install Prerequisites:

   npm install -g mcp-remote
   

2. Copy the Plugin Folder to your global Antigravity plugins directory.
3. Authenticate:

   node bin/clickup-mcp.js auth
   

   Note: This will launch your default web browser. Log in, authorize, then return to your terminal and press ENTER.
4. Sync & Map Projects:

   # List remote ClickUp Spaces & Lists
   node bin/clickup-mcp.js projects remote
   
   # Map a local folder to a ClickUp List
   node bin/clickup-mcp.js projects add my-project "Backlog"
   

🛠️ Developer Reference

{
  "example-project": {
    "spaceId": "12345678",
    "listId": "87654321",
    "listName": "Tasks (Master)",
    "spaceName": "Product Development",
    "aliases": [
      "example-project-site",
      "example-project"
    ]
  }
}

{
  "userSettings": {
    "globalPermissionGrants": {
      "allow": [
        "command(node C:\\Users\\<YourUsername>\\.gemini\\config\\plugins\\clickup-mcp-plugin\\bin\\clickup-mcp.js)",
        "command(node /Users/<YourUsername>/.gemini/config/plugins/clickup-mcp-plugin/bin/clickup-mcp.js)"
      ]
    }
  }
}

⚖️ License

This project is licensed under the MIT License.