cortexaforge-clickup-mcp

A free, MIT-licensed, fully-featured Model Context Protocol server for ClickUp. Works with Claude Desktop, Claude Code, Hermes, OpenClaw, OpenAI Codex CLI, Cursor, Windsurf, and any MCP-compatible client.

No paywall. No license keys. No "premium tier."

Built from scratch against ClickUp's public REST API. Not derived from, and not affiliated with, any proprietary ClickUp MCP server.

Why

Other ClickUp MCP servers gate features behind a paid license. This one doesn't — it's MIT and you can use, fork, or extend it freely. It also supports both stdio and Streamable HTTP transports out of the box, so it works in agent gateways like Hermes and OpenClaw without modification.

Status

Phase 1 (current — v0.1.x) — 18 tools across:

• Workspace hierarchy
• Tasks (CRUD + search)
• Comments
• Time tracking
• Docs (read, create, append)

Phase 2 (planned) — multi-workspace switching, custom fields, checklists, subtasks, dependencies, attachments, tags, views, goals (~40-60 tools).

Phase 3 (planned) — chat channels, webhooks, guests, automations, sprints, full ~150 tool parity with the proprietary alternative.

Quickstart

1. Get your ClickUp credentials

• API key: ClickUp → top-right avatar → Settings → Apps → API Token → generate a personal token starting with pk_.
• Team ID: open ClickUp in your browser — the URL contains /t/<TEAM_ID>/. Or run the curl in INSTALL.md.

2. Add to your MCP client

See docs/INSTALL.md for one-paste configs for every supported client:

• Claude Desktop
• Claude Code (CLI)
• Hermes
• OpenClaw
• OpenAI Codex CLI
• Cursor / Windsurf / generic STDIO host
• Generic HTTP host

3. Talk to it

Once installed, ask your AI agent things like:

• "Show me my ClickUp workspace hierarchy."
• "Create a task in the Client Onboarding list called 'Send kickoff email' due tomorrow."
• "Start a timer on the 'Quarterly review' task."
• "Append a page called 'Decision Log — May 25' to the CortexaForge Playbook doc with this content: …"

Tools

18 tools, each accepts names or IDs — you don't need to look up IDs. See docs/TOOLS.md for full reference.

Security

The API key has full read/write access to your ClickUp workspace. Never commit it. This repo ships a .env.example only; your real .env is gitignored. When configuring an MCP host, paste the key into that host's config file (e.g. claude_desktop_config.json), which lives outside any code repo.

License

MIT. Use it, fork it, sell it, ship it — just keep the copyright notice.

Contributing

Issues and PRs welcome. Phase 2 / Phase 3 tools are tracked in issues.