Developer Tools / MCP

MCP Integration

Connect AI tools to your ClickUp WhatsApp workspace. The hosted MCP endpoint is the default setup. Local stdio is only needed when you are running the repo yourself.

List Chats

List WhatsApp chats and groups captured by your workspace. Use the returned chat id in search and context tools.

Search Messages

Find conversations by text, sender, date range, chat, and media presence.

Message Context

Fetch nearby messages before and after a specific WhatsApp message in the same chat.

Quickstart

Complete the ClickUp and WhatsApp setup in the dashboard.
Choose which groups to track in Group Sync.
Copy your MCP token from the MCP Setup card.
Use the hosted Streamable HTTP endpoint unless your client only supports local stdio.

Token variable used by examples

export CLICKUP_MCP_TOKEN="paste_token_from_dashboard"

Hosted MCP endpoint

POST https://clickup.whasupcrm.com/api/mcp

Client setup

Claude Code

export CLICKUP_MCP_TOKEN="paste_token_from_dashboard"
claude mcp add --transport http clickup-whatsapp https://clickup.whasupcrm.com/api/mcp \
  --header "Authorization: Bearer $CLICKUP_MCP_TOKEN"

Codex

export CLICKUP_MCP_TOKEN="paste_token_from_dashboard"
codex mcp add clickup-whatsapp --url https://clickup.whasupcrm.com/api/mcp --bearer-token-env-var CLICKUP_MCP_TOKEN

Cursor

Cursor mcp.json

{
  "mcpServers": {
    "clickup-whatsapp": {
      "url": "https://clickup.whasupcrm.com/api/mcp",
      "headers": {
        "Authorization": "Bearer paste_token_from_dashboard"
      }
    }
  }
}

VS Code Copilot

VS Code mcp.json

{
  "servers": {
    "clickup-whatsapp": {
      "type": "http",
      "url": "https://clickup.whasupcrm.com/api/mcp",
      "headers": {
        "Authorization": "Bearer paste_token_from_dashboard"
      }
    }
  }
}

Local stdio (repo dev)

Local stdio command

claude mcp add --scope user --transport stdio --env CLICKUP_MCP_TOKEN=paste_token_from_dashboard clickup-whatsapp -- bun --cwd apps/clickup run mcp

Tools

Tool	Description	Parameters
list_chats	Lists WhatsApp chats and groups captured by the ClickUp WhatsApp workspace.	installationId (optional sanity check)
search_messages	Searches captured WhatsApp messages by chat, text, date range, and media presence.	chatId, query, from, to, includeMediaOnly, limit, installationId
get_message_context	Fetches nearby messages before and after a specific WhatsApp message.	whatsappMessageId, before, after, installationId

Security

MCP tokens are scoped to one Whatsync installation and only expose that installation's tracked WhatsApp chats.
Treat the token like an API key. Do not commit it to version control.
The optional installationId argument is a sanity check. If present, it must match the token.

Official references

Claude Code MCP Cursor MCP VS Code MCP Codex MCP