Skip to content

feat: MCP server for Cursor / Claude Desktop integration - #8

Merged
davidminin merged 1 commit into
mainfrom
feat/mcp-integration
Apr 19, 2026
Merged

feat: MCP server for Cursor / Claude Desktop integration#8
davidminin merged 1 commit into
mainfrom
feat/mcp-integration

Conversation

@davidminin

Copy link
Copy Markdown
Owner

Summary

Adds a local MCP (Model Context Protocol) server that connects your IDE directly to ClickUp tasks and GitHub repos. Claim tickets, implement features, and submit PRs — all without leaving Cursor.

New Files

File Purpose
worker/src/mcp-server.ts MCP server — 9 tools, 1 resource, 1 prompt template
worker/src/lib/clickup-client.ts ClickUp REST API v2 client
worker/src/lib/github-client.ts GitHub REST API client
worker/src/lib/portal-client.ts Portal worker registration client
.cursor/mcp.json Auto-detected Cursor MCP config

Updated Files

  • README.md — MCP docs, updated architecture diagram, roadmap
  • worker/package.json — added @modelcontextprotocol/sdk, zod
  • worker/.env.example — MCP-specific env vars

MCP Tools

Tool Description
list_tasks List ClickUp tasks (filter by status)
get_task Full task details + comments
claim_task Assign to you + set "in progress" + create branch
update_task_status Change task status
add_comment Post to ClickUp task
complete_task Mark done + attach PR link
create_branch Create feature branch from main
create_pr Open a pull request
list_kb Browse Knowledge Base articles

Setup

cd worker && npm install
cp .env.example .env  # fill CLICKUP_API_TOKEN + GITHUB_TOKEN
# Restart Cursor — it auto-detects .cursor/mcp.json

ClickUp task: https://app.clickup.com/t/86e0yp09t

Adds a local MCP server that connects your IDE directly to ClickUp tasks
and GitHub repos. Claim tickets, implement features, and submit PRs
without leaving your editor.

- worker/src/mcp-server.ts: MCP server with 9 tools + resources + prompts
- worker/src/lib/: ClickUp, GitHub, Portal API clients
- .cursor/mcp.json: Auto-detected Cursor MCP config
- README.md: MCP docs, updated architecture diagram, roadmap
- worker/package.json: added @modelcontextprotocol/sdk, zod deps
@davidminin
davidminin merged commit 583b123 into main Apr 19, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant