How do I use Taskade MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Taskade MCP Server create a task in my Marketing project to review the Q3 campaign" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Taskade MCP Server

by mateusztakahashi

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

Taskade MCP Server

Connect Taskade to Claude, Cursor, VS Code, Windsurf and any other client of the Model Context Protocol.

Add to Cursor Install in VS Code Connect in Claude

npm GitHub stars License

Hosted server: https://www.taskade.com/mcp (Streamable HTTP, OAuth). Nothing to install.

This repo holds two packages:

MCP Server (@taskade/mcp-server): the local stdio server, for clients that cannot connect to a remote server.
OpenAPI Codegen: generate MCP tools from any OpenAPI spec, not only Taskade.

Related MCP server: Taskade MCP Server

Demo

MCP-powered Taskade agent running inside Claude Desktop by Anthropic:

Taskade MCP Demo: AI agent managing tasks and projects in Claude Desktop

Build Agents via MCP	Automate Workflows	Manage Projects

Create, train, deploy AI agents from Claude/Cursor	Build multi-step automations across 100+ services	Full workspace management from your AI assistant (paid plans)

Quick Start: hosted server


URL	`https://www.taskade.com/mcp`
Transport	Streamable HTTP
Auth	OAuth 2.0 with PKCE and dynamic client registration. Your client opens a Taskade sign-in page once.
Plan	MCP access is part of every paid Taskade plan (Starter and up). On the Free plan, `list_spaces` returns no workspaces.
Discovery	`https://www.taskade.com/.well-known/oauth-protected-resource/mcp`

An initialize request without a token returns 401 on purpose. The 401 tells your client where to start the OAuth sign-in.

Claude (web, Desktop and mobile)

In Claude, go to Customize > Connectors and select Add custom connector. On a Team or Enterprise plan, an Owner first adds the connector in Organization settings > Connectors (Add, then Custom).
Enter the name Taskade and the URL https://www.taskade.com/mcp, then select Add.
Select Connect, sign in to Taskade, and approve access.
In a chat, select + > Connectors and turn on Taskade.

If the dialog asks for an OAuth client, select Register automatically. The connector also works in Claude Desktop and the Claude mobile apps on the same account.

Claude Code

claude mcp add --transport http taskade https://www.taskade.com/mcp

Then run /mcp in Claude Code and select taskade to sign in.

Cursor

Select Add to Cursor at the top of this page, or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "taskade": {
      "url": "https://www.taskade.com/mcp"
    }
  }
}

VS Code

Select Install in VS Code at the top of this page, or run:

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

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "taskade": {
      "serverUrl": "https://www.taskade.com/mcp"
    }
  }
}

Other clients and servers (API token)

A client that cannot do OAuth can send a Taskade personal access token as a Bearer token. Create the token in Taskade Settings > API.

{
  "mcpServers": {
    "taskade": {
      "type": "http",
      "url": "https://www.taskade.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TASKADE_API_TOKEN" }
    }
  }
}

Full guide: Hosted Taskade MCP.

Hosted tools (48)

Every hosted tool declares MCP tool annotations. Claude can run a read-only tool without a confirmation, and it asks before a tool that deletes or replaces data.

Area	Read-only tools	Write tools
Workspaces	`list_spaces`, `list_folders`, `list_media`, `list_templates`, `inspect_space`, `list_automations`	`write_file` (Genesis app source in `app/`)
Projects	`list_projects`, `list_my_projects`, `get_project`, `read_project`, `list_fields`, `list_blocks`, `list_project_members`, `get_share_link`	`create_project`, `create_project_from_template`, `copy_project`, `complete_project`, `restore_project`, `enable_share_link`
Tasks	`list_tasks`	`create_task`, `update_task`, `complete_task`, `uncomplete_task`, `delete_task`, `move_task`, `set_task_note`, `delete_task_note`, `set_task_date`, `delete_task_date`, `assign_task`, `unassign_task`, `set_task_field_value`, `delete_task_field_value`
AI agents	`list_agents`, `get_agent`, `list_conversations`, `get_conversation`	`create_agent`, `update_agent`, `delete_agent`, `prompt_agent`, `add_knowledge_project`, `remove_knowledge_project`, `add_knowledge_media`, `remove_knowledge_media`

The server also serves the resource taskade://getting-started, a short guide for the model.

Example prompts

Weekly review. "List my Taskade workspaces, read the Q4 Roadmap project, and give me the open tasks grouped by assignee." Tools: list_spaces, list_projects, read_project.
Plan a launch. "Create a project called Website Launch in my Marketing workspace with tasks for copy, design, QA and launch day, and set the launch task to November 3." Tools: list_spaces, create_project, create_task, set_task_date.
Build a support agent. "Create an agent called Help Bot in my Support workspace, add the FAQ project as its knowledge, then ask it how a customer resets a password." Tools: create_agent, add_knowledge_project, prompt_agent.
Close out a sprint. "In the Sprint 42 project, mark every task that mentions 'shipped' as complete, then mark the project as completed." Tools: list_tasks, complete_task, complete_project.
Edit a Genesis app. "In my CRM app, read app/src/App.tsx and change the page title to Acme CRM." Tools: inspect_space, write_file.

Troubleshooting

Symptom	Cause and fix
`401 Unauthorized` on the first request	Expected. Your client must start the OAuth sign-in. If it does not, update the client or use an API token (see above).
`list_spaces` returns no workspaces	MCP access needs a paid plan on that workspace. Upgrade at taskade.com/pricing.
A tool returns "permission denied"	Your role in that workspace or project does not allow the action. Ask a workspace owner for access.
Claude shows "Authorization with the MCP server failed"	Remove the connector, add it again, and sign in to the correct Taskade account.
A local `npx` server fails with "TASKADE_API_KEY appears to be invalid"	Create a new token in Settings > API.

If the problem continues, open an issue or email support@taskade.com.

Local package (stdio)

Use the local package when your client supports only stdio servers, or when you need a tool that only the local package has, for example the webhook tools (subscribeWebhook, unsubscribeWebhook). It runs on your machine with npx and calls the Taskade public API over the network with a personal access token.

I want to...	Use	Where / auth
Use Taskade from Claude, Cursor, VS Code or another client that supports remote servers	Hosted server	`https://www.taskade.com/mcp` · OAuth 2.0 or API token · paid plans
Run Taskade tools in a client that supports only stdio, or use the webhook tools	Local package (`@taskade/mcp-server`)	`npx` · personal access token · needs network access to taskade.com
Let my Taskade agents reach Slack, Shopify or Gmail	MCP Connectors	Hosted, in the Taskade app

1. Get Your API Key

Go to Taskade Settings > API and create a Personal Access Token.

2. Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "your-api-key-here"
      }
    }
  }
}

4. Windsurf

Add to ~/.codeium/windsurf/mcp_config.json (or Settings → Cascade → MCP → Add Server):

{
  "mcpServers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "your-api-key-here"
      }
    }
  }
}

5. Cline

In VS Code, open the Cline MCP Servers panel → Configure MCP Servers and add:

{
  "mcpServers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "your-api-key-here"
      }
    }
  }
}

6. VS Code

Add a .vscode/mcp.json to your workspace (VS Code uses the servers key; ${input:…} prompts for your key on first run):

{
  "servers": {
    "taskade": {
      "command": "npx",
      "args": ["-y", "@taskade/mcp-server"],
      "env": {
        "TASKADE_API_KEY": "${input:taskade_api_key}"
      }
    }
  }
}

7. HTTP / SSE Mode (remote & custom clients)

TASKADE_API_KEY=your-api-key npx @taskade/mcp-server --http

The server starts at http://localhost:3000 (configure with PORT env var). Connect via SSE at http://localhost:3000/sse?access_token=your-api-key.

Local package tools (62)

The local package has its own tool names. They map to the Taskade public API v1 and v2.

Workspaces

Tool	Description
`workspacesGet`	List all workspaces
`workspaceFoldersGet`	List folders in a workspace
`workspaceCreateProject`	Create a project in a workspace

Projects

Tool	Description
`projectGet`	Get project details
`projectCreate`	Create a new project
`projectCopy`	Copy a project to a folder
`projectComplete`	Mark project as completed
`projectRestore`	Restore a completed project
`projectMembersGet`	List project members
`projectFieldsGet`	Get custom fields for a project
`projectShareLinkGet`	Get the share link
`projectShareLinkEnable`	Enable the share link
`projectBlocksGet`	Get all blocks in a project
`projectTasksGet`	Get all tasks in a project
`folderProjectsGet`	List projects in a folder

Tasks

Tool	Description
`taskGet`	Get task details
`taskCreate`	Create one or more tasks
`taskPut`	Update a task
`taskDelete`	Delete a task
`taskComplete`	Mark task as complete
`taskUncomplete`	Mark task as incomplete
`taskMove`	Move a task within a project
`taskAssigneesGet`	Get task assignees
`taskPutAssignees`	Assign users to a task
`taskDeleteAssignees`	Remove assignees
`taskGetDate`	Get task due date
`taskPutDate`	Set task due date
`taskDeleteDate`	Remove task due date
`taskNoteGet`	Get task note
`taskNotePut`	Update task note
`taskNoteDelete`	Delete task note
`taskFieldsValueGet`	Get all field values
`taskFieldValueGet`	Get a specific field value
`taskFieldValuePut`	Set a field value
`taskFieldValueDelete`	Delete a field value

AI Agents

Create, manage, and publish autonomous AI agents with custom knowledge and tools.

Tool	Description
`folderAgentGenerate`	Generate an AI agent from a text prompt
`folderCreateAgent`	Create an agent with custom configuration
`folderAgentGet`	List agents in a folder
`agentGet`	Get agent details
`agentUpdate`	Update agent configuration
`deleteAgent`	Delete an agent
`agentPublicAccessEnable`	Publish agent publicly
`agentPublicGet`	Get public agent details
`agentPublicUpdate`	Update public agent settings
`agentKnowledgeProjectCreate`	Add a project as agent knowledge
`agentKnowledgeMediaCreate`	Add media as agent knowledge
`agentKnowledgeProjectRemove`	Remove project from knowledge
`agentKnowledgeMediaRemove`	Remove media from knowledge
`agentConvosGet`	List agent conversations
`agentConvoGet`	Get conversation details
`publicAgentGet`	Get agent by public ID

Templates

Tool	Description
`folderProjectTemplatesGet`	List available project templates
`projectFromTemplate`	Create a project from a template

Media

Tool	Description
`mediasGet`	List media files in a folder
`mediaGet`	Get media details
`mediaDelete`	Delete a media file

Personal

Tool	Description
`meProjectsGet`	List all your projects

Agent Chat & Webhooks (API v2, beta)

Capabilities the v1 API doesn't have: hold a live conversation with an AI agent, and receive real-time events.

Tool	Description
`promptAgent`	Send a message to an AI agent and get its reply
`listConversations`	List an agent's conversations
`getConversation`	Get a conversation's messages
`subscribeWebhook`	Subscribe to real-time Taskade event webhooks
`unsubscribeWebhook`	Remove a webhook subscription

Why Taskade MCP?

Taskade MCP gives your AI assistant access to your workspace — projects, tasks, agents, knowledge bases, templates, and automations (on paid plans; some endpoints such as workspace listing are gated for free accounts). Instead of writing API code, describe what you need in natural language.

┌──────────────────────────────────────────────────────────┐
│                HOW TASKADE MCP WORKS                     │
└──────────────────────────────────────────────────────────┘

  You (in Claude/Cursor/Windsurf):
  "Create a support agent trained on our docs project"
                         ↓
  ┌──────────────────────────────────┐
  │     Taskade MCP Server           │
  │     (62 tools, 8 categories)     │
  └──────────────────────────────────┘
       ↓              ↓            ↓
  folderCreateAgent  agentKnowledge  agentPublicAccess
  (creates agent)    (attaches docs)  (publishes it)
                         ↓
  Result: Live AI chatbot trained on your data

What You Say	What Happens
"Show me all overdue tasks"	Reads projects → filters tasks → formats report
"Create a support agent trained on our docs"	Creates agent → attaches knowledge → publishes
"Set up next week's sprint from our template"	Copies template → populates tasks → assigns team
"Summarize yesterday's completed work"	Reads task history → generates standup summary

Why MCP Instead of REST API?

	REST API	MCP Server
Setup	Write HTTP client, handle auth, parse JSON	`npx @taskade/mcp-server` — one command
Interface	Code against endpoints	Natural language — describe what you need
Chaining	Manual orchestration	AI chains tools intelligently
Error handling	Write error handling code	AI interprets errors and retries

Why Taskade MCP Over Other MCP Servers?

Taskade is the only MCP server that includes AI agent management (create, train, deploy agents), knowledge base training (attach docs, projects, media), and OpenAPI codegen (generate MCP tools from any API spec). 62 tools across 8 categories.

Agent Recipes

Problem: Team standup notes scattered across Slack, email, and docs.

You: "Check my Taskade workspace for yesterday's completed tasks,
      summarize them as a standup update, then create today's
      priority tasks based on what's still open."

Claude uses:
  1. meProjectsGet → find your active projects
  2. projectTasksGet → pull tasks from each project
  3. taskCreate → create today's priority tasks

Result: A formatted standup summary + fresh task list in Taskade.

Problem: You have docs scattered across files and need an AI agent trained on them.

You: "Create an AI support agent called 'Help Bot' in my
      Customer Success folder, train it on our Documentation
      project, and publish it publicly."

Claude uses:
  1. workspaceFoldersGet → find "Customer Success" folder
  2. folderCreateAgent → create "Help Bot" with support instructions
  3. agentKnowledgeProjectCreate → attach Documentation project
  4. agentPublicAccessEnable → publish with shareable link

Result: Live AI chatbot trained on your docs, ready to embed.

Problem: Creating sprint projects manually every two weeks.

You: "Create a new sprint project from our 'Sprint Template',
      name it 'Sprint 2026-W15', move the top 10 backlog
      items into it, and assign them to the engineering team."

Claude uses:
  1. folderProjectTemplatesGet → find "Sprint Template"
  2. projectFromTemplate → create "Sprint 2026-W15"
  3. projectTasksGet → get backlog items
  4. taskMove → move top 10 tasks to new sprint
  5. taskPutAssignees → assign engineering team members

Result: Sprint ready to go, fully populated and assigned.

This server cannot be deployed

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

AurentiaOAuth
fr.aurentia
Your Aurentia workspace — projects, CRM, tasks, deliverables — in Claude, Cursor or any MCP client.
CRM Project Management Workplace & Productivity
1
LooperTaskOAuth
com.loopertask
AI-native Kanban board — connect Claude to claim, work and move your tasks over MCP.
Project Management Workplace & Productivity
1
Tasg
app.tasg
Work management where AI agents are first-class members: tasks, projects, memory over hosted MCP
Project Management Autonomous Agents Knowledge & Memory
1
ainote BOAuth
io.github.seunghan91
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.
Note Taking Developer Tools Knowledge & Memory
3

Related MCP Servers

Taskade MCP Server
Project Management Workplace & Productivity Autonomous Agents
Leone542
A
license
Not graded
quality
A
maintenance
Enables AI assistants like Claude, Cursor, VS Code, and Windsurf to manage workspaces, projects, tasks, and AI agents through natural language, with a hosted OAuth server or a local stdio package. Also supports generating MCP tools from any OpenAPI spec.
Updated 4 days ago (2026-10-14 16:04 UTC)
1,107 npm
MIT
Taskade MCP Server
Project Management Workplace & Productivity AI & Machine Learning
ambermoretti373
A
license
Not graded
quality
A
maintenance
Enables clients such as Claude, Cursor, VS Code, and Windsurf to manage workspaces, projects, tasks, and AI agents through a hosted OAuth endpoint or a local stdio package, and to generate MCP tools from OpenAPI specs.
Updated 2 days ago (2026-10-16 10:24 UTC)
1,107 npm
MIT
Taskade MCP Server
Project Management Workplace & Productivity App Automation
tongchai00
A
license
Not graded
quality
A
maintenance
Enables AI clients such as Claude, Cursor, VS Code, and Windsurf to list and manage workspaces, projects, tasks, AI agents, and automations through a hosted OAuth-secured endpoint or a local stdio package. Also generates MCP tools from any OpenAPI spec.
Updated 2 days ago (2026-10-16 10:48 UTC)
1,107 npm
MIT
Taskade MCP Server
Project Management Workplace & Productivity AI & Machine Learning
Jian9112
A
license
Not graded
quality
A
maintenance
Enables AI clients such as Claude, Cursor, VS Code, and Windsurf to manage workspaces, projects, tasks, and AI agents through natural language, using a hosted OAuth-authenticated endpoint or a local stdio package. It also ships an OpenAPI codegen tool for generating MCP tools from any OpenAPI spec.
Updated a day ago (2026-10-17 10:11 UTC)
1,107 npm
MIT

Taskade MCP Server

Contents

Demo

Quick Start: hosted server

Claude (web, Desktop and mobile)

Claude Code

Cursor

VS Code

Windsurf

Other clients and servers (API token)

Hosted tools (48)

Example prompts

Troubleshooting

Local package (stdio)

1. Get Your API Key

2. Claude Desktop

3. Cursor

4. Windsurf

5. Cline

6. VS Code

7. HTTP / SSE Mode (remote & custom clients)

Local package tools (62)

Workspaces

Projects

Tasks

AI Agents

Templates

Media

Personal

Agent Chat & Webhooks (API v2, beta)

Why Taskade MCP?

Why MCP Instead of REST API?

Why Taskade MCP Over Other MCP Servers?

Agent Recipes

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Taskade MCP Server

Taskade MCP Server

Taskade MCP Server

Taskade MCP Server