Bridge MCP Server
Provides tools for AI to interact with ClickUp, allowing for the management of tasks, projects, time tracking, and task templates.
Click on "Deploy 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 deployed
Related MCP Connectors
Kaiva Bridge turns your API, database or documents into a managed MCP server for Claude, ChatGPT, Cursor and VS Code. Point it at an OpenAPI or Swagger spec, an API docs link, a cURL command, a Postman collection, a GraphQL endpoint, Postgres, MySQL, MariaDB or SQL Server, spreadsheets, PDFs and other documents, or an MCP server you already run. Bridge reads the source and proposes tools, and you choose which ones your AI client sees. No code to write and nothing to run. Connect this server and your agent does the setup for you: it lists your servers, shows one, drafts a new server from an OpenAPI spec, and refreshes a server's tools when its API changes. Free plan: 10 servers and 200,000 tool calls a month, no credit card. Pricing: https://kaiv.ai/bridge/pricing Security: https://kaiv.ai/bridge/security Docs: https://kaiv.ai/bridge/docs
The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows