Taskade MCP server

Taskade MCP Server and Agent Plugin

Taskade is the AI-native workspace for projects, AI agents and automations. Taskade Genesis builds a running app from one prompt.

Connect Taskade to Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code, GitHub Copilot, Gemini CLI, Windsurf and any other client of the Model Context Protocol.

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

This repo holds the Taskade agent plugin and 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.

---

Agent plugin for Claude Code, Codex, Copilot, Gemini CLI and Cursor

The taskade plugin connects your AI tool to your Taskade workspace through the hosted server, and adds 7 skills: a front door (taskade) and six jobs (getting-started, import-spreadsheet, fix-my-app, app-report, backup-my-app, plan-new-app). The skills tell the agent which tools to call, in which order, and what to check before it reports back.

• Plan: MCP access is part of every paid Taskade plan (Starter and up). Sign in once with your Taskade account.
• What it does: imports a spreadsheet into a project, fixes a Taskade Genesis app one checked change at a time, reports on your projects and automations, backs up an app to a folder, and plans a new app.
• What stays in Taskade: the plugin cannot create or edit an automation, build or publish an app, or set who can use an app. For those jobs, it writes the request for you to paste into Taskade EVE.

Host	Install
Claude Code	claude plugin marketplace add taskade/mcp, then claude plugin install taskade@taskade. Run /mcp, select taskade and sign in.
Codex	codex plugin marketplace add taskade/mcp, then codex plugin add taskade@taskade
GitHub Copilot CLI	copilot plugin install taskade/mcp
Gemini CLI	gemini extensions install https://github.com/taskade/mcp
VS Code	See below
Cursor	See below
Any other agent	npx skills add https://github.com/taskade/mcp installs the skills only. Then add the hosted server https://www.taskade.com/mcp to the agent and sign in (see the quick start).

VS Code: turn on the chat.plugins.enabled setting. Then run Chat: Install Plugin From Source from the Command Palette and enter https://github.com/taskade/mcp.

Cursor: the Cursor plugin taskade (.cursor-plugin/) in this repository adds the same hosted server and skills.

To add only the hosted server to Codex, run codex mcp add taskade --url https://www.taskade.com/mcp, then codex mcp login taskade.

---

Contents

• Agent plugin
• Taskade MCP server: quick start (Claude, Claude Code, ChatGPT, Cursor, VS Code, Windsurf)
• Hosted tools
• Example prompts
• Troubleshooting
• Local package (stdio)
• Local package tools (62)
• Why Taskade MCP?
• Agent Recipes
• OpenAPI Codegen
• What is Taskade?
• Privacy & Security
• Support
• Contributing
• License

---

Demo

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

Build Agents via MCP	Run Automations	Manage Projects
Create, train, deploy AI agents from Claude/Cursor	List automations, run one, and read its runs	Full workspace management from your AI assistant (paid plans)

---

Taskade MCP server: quick start

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)

1. 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).
2. Enter the name Taskade and the URL https://www.taskade.com/mcp, then select Add.
3. Select Connect, sign in to Taskade, and approve access.
4. 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.

ChatGPT

ChatGPT connects to a remote MCP server as a custom connector in developer mode. It uses OAuth only.

1. In ChatGPT settings, turn on developer mode for apps and connectors.
2. Create a connector. Enter Taskade as the name and https://www.taskade.com/mcp as the server URL.
3. Select OAuth as the authentication. Sign in to Taskade and allow access.

Developer mode is available only on some ChatGPT plans, and its labels change often.

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

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	write_file (Genesis app source in app/)
Automations	list_automations, get_flow_runs	run_flow
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

• get_flow_runs: reads the recent runs of one automation, newest first. Each run has its status and times. A failed run also names the failed step and a short error. It needs edit rights on automations.
• run_flow: starts one run of an automation that is On and starts "When asked". Every run is real: it counts toward the monthly automation runs of the plan, and AI steps use credits.

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

---

Example prompts

1. 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.
2. 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.
3. 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.
4. 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.
5. 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. Remote and HTTP clients

The local package runs over stdio only. It has no HTTP or SSE mode. For a client that connects over HTTP, use the hosted server at https://www.taskade.com/mcp (see Taskade MCP server: quick start).

---

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 the completed work in my Sprint project"	Reads completed tasks → generates a 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 MCP 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.

---