Connect your AI Agents to ClickUp in minutes

Merge lets you securely connect your agents to ClickUp and thousands of tools instantly

Available tools

create_checklist

Create a checklist on a task

update_checklist

Update a checklist name

delete_checklist

Delete a checklist permanently

create_checklist_item

Add an item to a checklist

update_checklist_item

Update a checklist item

delete_checklist_item

Delete a checklist item permanently

get_task_comments

Get all comments for a task

create_task_comment

Create a comment on a task

update_comment

Update a comment

delete_comment

Delete a comment permanently

get_folders

Get all folders in a space

create_folder

Create a new folder in a space

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11
Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}
Copy Code
Copied!

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }
Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}
Copy Code

FAQs on using Merge's ClickUp  MCP server

FAQs on using Merge's ClickUp  MCP server

What is a ClickUp MCP server?

It’s an MCP server that exposes data and functionality from ClickUp via tools. Your agents can use these tools to update tasks, create checklists, share folders in a Slack channel, and more.

How can I use the ClickUp MCP server?

Here are just a few use cases (these also apply to other project management Model Context Protocol servers):

  • Create and triage tasks from natural language. Convert a chat transcript or meeting notes into a set of tasks with owners and deadlines
  • Bi-directional project status reporting: Pull the real-time task and sprint status for a team, then generate a weekly update (what shipped, what’s blocked, what’s at risk). You can then answer questions like “What’s overdue in the Launch list?”
  • Automated backlog grooming. Find stale tasks (no updates in 14+ days), label them, and @mention owners for an update
  • Customer-driven work intake: Turn inbound requests (e.g., from Slack) into ClickUp tasks with a consistent template: customer, impact, urgency, links, and acceptance criteria. Your agent can then auto-route requests to the right list based on keywords
  • Manage time tracking and capacity planning. Summarize where time is being spent by team/project and flag overloaded assignees. Your agent can even recommend task reassignments based on capacity and due dates

What are popular tools for ClickUp’s MCP server?

Here are some popular tools across data types:

Folders

  • <code class="blog_inline-code">get_folder</code>
  • <code class="blog_inline-code">create_folder</code>
  • <code class="blog_inline-code">update_folder</code>
  • <code class="blog_inline-code">delete_folder</code>

Tasks

  • <code class="blog_inline-code">create_task</code>
  • <code class="blog_inline-code">get_tasks</code>
  • <code class="blog_inline-code">add_task_tag</code>
  • <code class="blog_inline-code">Remove_task_tag</code>

Checklists

  • <code class="blog_inline-code">create_checklist_item</code>
  • <code class="blog_inline-code">update_checklist</code>
  • <code class="blog_inline-code">delete_checklist</code>
  • <code class="blog_inline-code">delete_checklist_item</code>

What makes Merge Agent Handler’s ClickUp MCP server better than alternative ClickUp MCP servers?

Using Merge Agent Handler’s ClickUp MCP server, you’ll not only get access to 40+ tools but also get:

  • Enterprise-grade security and DLP: Tool inputs and outputs are scanned for sensitive data, with rules to block, redact, or mask content
  • Real-time observability and auditability: Every tool call is logged, producing a complete audit trail with fully-searchable logs for debugging and compliance
  • Managed authentication and permissions: Merge handles credential storage, dynamic auth flows, and shared vs. individual authentication per MCP connector
  • Evaluation before production: Tools can be validated against expected outcomes prior to deployment

Can I set custom security rules for ClickUp tool calls in Merge Agent Handler?

Yes. Merge Agent Handler includes a Security Gateway with Data Loss Protection (DLP) that allows you to define default and custom rules governing what data agents can send to or receive from tools.

Here are some examples:

  • You can block ClickUp tool calls that try to write payment card data into task titles, descriptions, comments, or custom fields
  • You can block or redact social security numbers and other government ID patterns in any ClickUp content an agent attempts to create or update
  • You can mask customer identifiers (for example, internal account IDs) when an agent reads ClickUp tasks, so that the agent cannot copy that identifier into another system
  • You can block tool calls that include API keys, bearer tokens, or credentials inside ClickUp text fields (for example, if an agent tries to paste a secret into a task comment)

How can I start using Merge Agent Handler’s ClickUp MCP server?

You can follow these steps:

1. Sign up for Merge Agent Handler and log in.

2. Create a Tool Pack from the Tool Packs section.

3. Add the ClickUp connector to that Tool Pack.

4. Configure authentication for the ClickUp connector (for example, choose shared authentication or individual authentication, depending on your setup).

5. Select which ClickUp tools you want to expose in the Tool Pack (you can keep it minimal while testing).

6. Create a Registered User (this is the identity container that will hold the credentials used to execute tool calls).

7. Complete the ClickUp authentication flow for that Registered User, so the ClickUp tools become available for authenticated execution.

8. Copy the MCP entry URL for your Tool Pack + Registered User and add it to your MCP client configuration (your agent can now call ClickUp tools through Agent Handler).

9. Test a few ClickUp tool calls end-to-end in the Playground and confirm that logs are being generated as expected.

Explore other MCP servers built and managed by Merge

airtable
Airtable
anaplan
Anaplan
asana
Asana
basecamp
Basecamp
box
Box
calendly
Calendly
confluence
Confluence
contentful
Contentful
datadog
Datadog
dropbox
Dropbox
figma
Figma
freshdesk
Freshdesk
front
Front
github
GitHub
gitlab
GitLab
gmail
Gmail
gong
Gong
google_calendar
Google Calendar
google_drive
Google Drive
google_sheets
Google Sheets
greenhouse
Greenhouse
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
linear
Linear
microsoft_teams
Microsoft Teams
miro
Miro
monday
Monday.com
notion
Notion
onedrive
OneDrive
outlook
Outlook
pipedrive
Pipedrive
quickbooks_online
QuickBooks Online
sapsf
SAP SuccessFactors
salesforce
Salesforce
sendgrid
SendGrid
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
slack
Slack
stripe
Stripe
teamwork
Teamwork.com
trello
Trello
weather
Weather
wikipedia
Wikipedia
workday
Workday
zendesk
Zendesk
zendesk_sell
Zendesk Sell
zohocrm
Zoho CRM
zohodesk
Zoho Desk
zoom
Zoom

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now