Provides tools for AI to interact with ClickUp, allowing for the management of tasks, projects, time tracking, and task templates.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Bridge MCP ServerCreate a task from my Project Kickoff template in ClickUp"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
š Bridge MCP Server
"You don't need another automation tool. You just need a bridge."
Connect Claude, Gemini, or any AI to your business tools via the Model Context Protocol (MCP).
What is this?
Bridge is a hosted MCP server that gives AI direct access to your tools:
ClickUp - Tasks, projects, time tracking, templates
Skills Library - Pre-built instructions for common workflows
(Coming soon) HubSpot, Guru, Google Analytics, and more
No workflows to build. No operations to count. Just ask your AI what you need.
Architecture
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
ā ā
ā Your AI (Claude/Gemini) ā
ā ā ā
ā ā¼ ā
ā āāāāāāāāāāāāāāāāāāā ā
ā ā Bridge MCP ā āāā Hosted on Google Cloud Run ā
ā ā Server ā ā
ā āāāāāāāāāā¬āāāāāāāāā ā
ā ā ā
ā āāāāāāāā“āāāāāāā ā
ā ā¼ ā¼ ā
ā ClickUp Skills ā
ā API Library ā
ā ā
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāFor Claude Code: Deployment Instructions
Hey Claude Code! Here's how to deploy this server to Google Cloud Run.
Prerequisites
Google Cloud CLI (
gcloud) installed and authenticatedA Google Cloud project with billing enabled
Cloud Run and Cloud Build APIs enabled
Step-by-Step Deployment
# 1. Navigate to this directory
cd /path/to/bridge-mcp
# 2. Make sure gcloud is authenticated
gcloud auth login
# 3. Set your project
gcloud config set project YOUR_PROJECT_ID
# 4. Enable required APIs
gcloud services enable cloudbuild.googleapis.com run.googleapis.com
# 5. Make deploy script executable and run it
chmod +x deploy.sh
./deploy.shOr Deploy Manually
# Build the container
gcloud builds submit --tag gcr.io/bridge-mcp/bridge-mcp
# Deploy to Cloud Run
gcloud run deploy bridge-mcp \
--image gcr.io/bridge-mcp/bridge-mcp \
--platform managed \
--region us-central1 \
--allow-unauthenticated \
--memory 512Mi \
--set-env-vars "SUPABASE_URL=...,SUPABASE_KEY=..."After Deployment
You'll get a URL like: https://bridge-mcp-xxxxx-uc.a.run.app
Health check:
https://YOUR_URL/healthMCP endpoint:
https://YOUR_URL/mcp
Connecting to Claude
Once deployed, add this MCP server to Claude:
Go to Claude settings ā Integrations ā MCP Servers
Add new server with URL:
https://YOUR_URL/mcpName it "Bridge"
Now you can ask Claude things like:
"Get my ClickUp task templates" (requires your ClickUp API key)
"Create a task from my Project Kickoff template"
"Load the transcript-to-tasks skill"
Project Structure
bridge-mcp/
āāā src/
ā āāā index.ts # Main server entry point
ā āāā connectors/
ā āāā clickup.ts # ClickUp API tools
ā āāā skills.ts # Skills library tools
āāā package.json
āāā tsconfig.json
āāā Dockerfile
āāā deploy.sh
āāā README.mdAdding New Connectors
To add a new connector (e.g., HubSpot):
Create
src/connectors/hubspot.tsExport a
registerHubSpotTools(server: McpServer)functionImport and call it in
src/index.tsRebuild and redeploy
Local Development
# Install dependencies
npm install
# Build TypeScript
npm run build
# Run locally
npm start
# Server runs at http://localhost:8080Skills Library
Bridge can fetch skills (instruction files) from GitHub repos.
Default repo: amara-ai/bridge-skills (update in src/connectors/skills.ts)
Skills are markdown files that teach AI how to perform tasks:
transcript-to-tasks- Turn meeting transcripts into ClickUp tasksclient-onboarding- Standard client onboarding workflowdaily-standup-summary- Summarize team progress
Environment Variables
Variable | Description | Default |
| Server port |
|
Note: API keys (ClickUp, HubSpot, etc.) are passed per-request by users, not stored on the server.
License
MIT - Built by AI Foundations by Amara
"I prompt like shit. But I get glorious results."
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.