Taskade MCP

Taskade MCP Server and Agent Plugin

[Taskade](https://www.taskade.com) is the AI-native workspace for projects, AI agents and automations. [Taskade Genesis](https://www.taskade.com/create) 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](https://modelcontextprotocol.io/).

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.

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:

---

Taskade MCP server: quick start

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.

• 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

| A tool returns