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)

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
Trigger Setup in Chat: Open your Antigravity IDE and type:

"Set up ClickUp for me"
The agent will automatically check prerequisites, run the OAuth login, and map your workspace folders.

Method B: Manual CLI Setup

Install Prerequisites:
```
npm install -g mcp-remote
```
Copy the Plugin Folder to your global Antigravity plugins directory.
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.

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

Project Mappings Format (clickup-projects.json)

The config file lists your workspace directories and aliases. When you run tools in a mapped folder, the target list ID is resolved automatically.

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

Auto-Approved Permissions (config.json)

To prevent Antigravity from prompting you for command confirmation every time, add the command prefix to the allow list under globalPermissionGrants in your global configuration file (~/.gemini/config/config.json):

{
  "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)"
      ]
    }
  }
}

(Replace <YourUsername> with your actual local username or use the absolute path to your home directory).

⚖️ License

This project is licensed under the MIT License.

MCP Servers