← Back to directory
T

Taskade MCP Server

Official
Run your Taskade workspace from any MCP-compatible AI client
GitHub source repository ↗
★ 165 Stars Category · Collaboration Very popular Source revision 1f59385dc973
62FMRS · C
Reliability
8/20
Security and permissions
11/20
Maintenance
13/20
Documentation
16/20
Setup experience
14/20

Officially maintained with broad tool coverage (62 tools spanning projects, tasks, agents, templates, media, and the newer v2 Agent Chat/Webhook tools), supports both stdio and HTTP/SSE transports, and bundles a reusable OpenAPI-to-MCP code generator; note that some capabilities are gated by paid plans and the personal token carries broad permissions that should be safeguarded.

Read the FMRS scoring method →

Taskade MCP Server (the official @taskade/mcp-server npm package) is Taskade's own Model Context Protocol server, exposing 62 tools across workspaces, projects, tasks, AI agents, knowledge bases, templates, media, and real-time webhooks to MCP clients like Claude Desktop, Cursor, Windsurf, Cline, and VS Code. It runs over stdio by default via npx, and can also run in HTTP/SSE mode (with a --http flag) for remote or custom clients. The same repository ships a separate OpenAPI-to-MCP code generator (@taskade/mcp-openapi-codegen) that can turn any OpenAPI 3.0+ spec into MCP tools, not just Taskade's own API. Note that this repo's Workspace MCP is distinct from the hosted, OAuth-protected Genesis App MCP at taskade.com/mcp described in Taskade's docs — that is a separate surface and outside the scope of this package.

Tools

workspacesGet
List all workspaces
workspaceFoldersGet
List folders in a workspace
workspaceCreateProject
Create a project in a workspace
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
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
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
folderProjectTemplatesGet
List available project templates
projectFromTemplate
Create a project from a template
mediasGet
List media files in a folder
mediaGet
Get media details
mediaDelete
Delete a media file
meProjectsGet
List all your projects
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

Setup

1) Go to Taskade Settings > API and create a Personal Access Token to use as TASKADE_API_KEY. 2) Add an mcpServers entry to Claude Desktop, Cursor, Windsurf, or Cline's MCP config with command npx, args ["-y", "@taskade/mcp-server"], and TASKADE_API_KEY set in env. 3) For VS Code, add a .vscode/mcp.json using the servers key; ${input:taskade_api_key} can prompt for the key on first run. 4) For remote or custom clients, run TASKADE_API_KEY=your-api-key npx @taskade/mcp-server --http to start in HTTP/SSE mode (default http://localhost:3000, configurable via PORT), then connect via SSE at /sse?access_token=your-api-key. 5) After connecting, confirm the tool list loads and grant permissions incrementally as you use write operations.

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

Fit and risk

Best for

  • Existing Taskade users (personal or paid plans) who want an AI assistant to read and write their workspace directly
  • Project/ops managers who want to bulk-manage projects, tasks, templates, and AI agents through a conversational interface
  • Developers who want to reuse the OpenAPI codegen to quickly turn their own API specs into MCP tools

Not for

  • Free-plan users needing full functionality — some endpoints (e.g. workspace listing) are gated on free accounts
  • Anyone wanting to edit a published Genesis App's code or needing hosted OAuth access — that requires the separate Genesis App MCP at taskade.com/mcp, not this Workspace MCP
  • Anyone wanting agents to reach third-party services like Slack, Shopify, or Gmail — that's handled by Taskade's MCP Connectors, not this server

Required permissions

  • Requires a Taskade Personal Access Token (TASKADE_API_KEY) supplied as an environment variable, marked required and secret
  • The token authorizes the server to call the Taskade public API (v1 and v2) on your behalf, with read/write access to workspaces, projects, tasks, agents, media, and webhooks
  • In HTTP/SSE mode the key is passed as a query parameter (?access_token=), so consider the local network exposure

Risks and side effects

  • The token has broad read/write scope; if leaked, an attacker could create, modify, or delete your Taskade tasks, projects, media, or agents
  • Tools like agentPublicAccessEnable make an agent publicly accessible — use carefully to avoid unintentionally exposing internal content
  • Webhook subscribe/unsubscribe tools can affect other automations relying on the same webhook; misuse can break existing integrations
  • Per the README, the server only talks to Taskade's own API (api/v1 and api/v2) and does not send data to other third parties, but the API key should still be handled like any sensitive credential

Troubleshooting

  1. Confirm a valid Personal Access Token was generated at Taskade Settings > API and is correctly set as TASKADE_API_KEY
  2. If npx fails to start the server, check network access to the npm registry and that the -y flag is present to skip interactive prompts
  3. Some endpoints (e.g. workspace listing) are restricted on free accounts — check your plan if you hit permission errors
  4. In --http mode, check the PORT environment variable and local port availability, and verify the SSE URL and access_token query parameter are correct
  5. For agent/knowledge tools, confirm the referenced project or media resource exists and is accessible to your account

Use cases

View, create, and manage Taskade workspace projects and tasks via natural language in Claude/Cursor
Create, train (attach project/media knowledge to), and publicly publish Taskade AI agents through conversation
Bulk-generate projects from templates (client onboarding, sprint setup) with auto-assigned tasks and due dates
Subscribe to Taskade webhooks or hold live conversations with published agents via the v2 Agent Chat tools (beta)
Use the bundled OpenAPI-to-MCP codegen to turn any OpenAPI 3.0+ spec into MCP tools

Supported clients

Claude DesktopFull support
CursorFull support
WindsurfFull support
ClineFull support
VS CodeFull support