Setup instructions

Below are the setup instructions for some of the most popular AI assistants.

Claude

Set up Claude to use the ClickUp MCP server!

Pro, Team, Enterprise

If you're on the Pro, Team, or Enterprise plan:

1. In a browser or the desktop app, navigate to Settings in the sidebar.
2. Scroll to Connectors at the bottom and click Add.
3. In the prompt, enter the following:

• Name: ClickUp
• Remote MCP Server URL: https://mcp.clickup.com/mcp

Free

If you're on the Free plan of Claude, you'll set up the MCP server from the Claude desktop app:

1. Go to your Claude desktop settings page.
2. Click on Developer section.
3. Click on edit config then open the claude_desktop_config.json with your editor of choice.
4. Add the following and restart the Claude desktop app:

{
  "mcpServers": {
    "clickup": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.clickup.com/mcp"]
    }
  }
}

Claude Code

Use the follow command: claude mcp add --transport http clickup https://mcp.clickup.com/mcp

Once you've opened a Claude Code session, run /mcp to go through the authentication flow.

Cursor

Install here, or from Cursor's MCP directory page.

Manual installation

To manually set up Cursor for the ClickUp MCP server, add the following to your mcp.json file:

{
  "mcpServers": {
    "clickup": {
      "url": "https://mcp.clickup.com/mcp"
    }
  }
}

VS Code

Set up VS Code to use the ClickUp MCP server!

Manual installation

To manually set up VS Code for the ClickUp MCP server, open a terminal and run the following command:

code --add-mcp '{"type":"http","name":"clickup","url":"https://mcp.clickup.com/mcp"}'

Then, from inside VS Code, go to your extensions section.

You will find ClickUp MCP at the bottom of the list of MCP servers.

Click the settings cogwheel on the ClickUp MCP and click Start Server.

Follow the links to finish the authentication flow.

Windsurf

To set up Windsurf for the ClickUp MCP server:

1. Press Ctrl + , on Windows or Cmd + , on Mac to open your Windsurf settings.
2. Under Scroll to Cascade, click MCP servers.
3. Click Add Server, then select Add custom server.
4. Copy the following JSON to your Windsurf MCP config file:
   JSON

   {
     "mcpServers": {
       "clickup": {
         "serverUrl": "https://mcp.clickup.com/mcp"
       }
     }
   }

ChatGPT

🔓

Note: In Team, Enterprise, and Edu workspaces, only owners and admins have permission to configure MCP servers.

To set up ChatGPT to use the ClickUp MCP server:

1. Navigate to Settings and click Connectors.
2. Add a custom connector with the server URL: https://mcp.clickup.com/mcp.
3. It will be visible in the Deep Research tool. This tool can be accessed by clicking the plus button next to the input text box.
4. You may need to add the server as a source.

Note: Connectors can only be used with Deep Research.

Setup a custom MCP server in ChatGPT

🧑‍💻

Note: Developer Mode must be used because the MCP server is not an official connector and is considered untrusted.

1. Navigate to Settings in ChatGPT.

2. Go to Apps and Connectors.

3. Scroll to the bottom. Under Advanced Settings, enable Developer Mode .

4. Return to the main Apps and Connectors page. The "Create" button should now be visible.

5. Click Create and select ClickUp as the connector.

6. Set the MCP Server URL: https://mcp.clickup.com/mcp

7. Set Authentication to OAuth.

8. Review the disclaimer and check the box for I understand and want to continue.

   

9. Complete the authentication process:

   1. Select your ClickUp Workspace.
   2. Click Connect.

10. Once connected, close the authentication window.

11. In ChatGPT, click the Plus button, then More, and select your custom connector.

    

12. Confirm that ClickUp is now available as a connector and test by requesting your ClickUp Workspace Hierarchy.

💡

Want to use the ClickUp connector in ChatGPT? Learn more

Other clients

👍

Vetted List: Reminder that if your MCP isn’t on our vetted list of supported clients above, you can request a review here.

You can configure most other clients to use ClickUp's MCP server with the following settings:

Command: npx
Arguments: -y mcp-remote https://mcp.clickup.com/mcp 
Environment: None