taskade/mcp

• MCP Server — Connect Taskade to Claude Desktop, Cursor, Windsurf, or any MCP client.
• OpenAPI Codegen — Generate MCP tools from any OpenAPI spec — not just Taskade.

---

Contents

• Demo
• Quick Start
• Tools (62)
• Why Taskade MCP?
• Agent Recipes
• Use Cases
• OpenAPI Codegen
• What is Taskade?
• Roadmap
• Contributing
• License

---

Demo

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

---

Quick Start

⚡ Prefer a hosted option? https://www.taskade.com/mcp is the OAuth-protected Genesis App MCP — a separate hosted surface from this Workspace MCP server. See its guide to learn what it does and whether it fits your use case. To read and write your workspace content (projects, tasks, agents) as described below, use the Workspace MCP server (this package).

Which Taskade MCP do I want?

Taskade speaks MCP through three surfaces — this repo is the first one:

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.

---

Tools (62)

Workspaces

Projects

Tasks

AI Agents

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

Templates

Media

Personal

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.

---

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

Why MCP Instead of REST API?

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

---

Use Cases

Project Management with AI

Ask your AI assistant to manage your Taskade workspace:

• “Show me all my projects and their status”
• “Create a new project called Q1 Planning with tasks for each team”
• “Move all overdue tasks to the Backlog project”
• “Set due dates for all tasks in the Sprint project”

AI Agent Creation

Build and deploy AI agents directly from your editor:

• “Create an AI agent called Customer Support Bot with knowledge from our docs project”
• “Generate an agent for code review using this prompt: …”
• “Publish my agent publicly and give me the share link”
• “Add our API documentation project as knowledge to the agent”

Template Workflows

Automate project creation from templates:

• “List all templates in my workspace”
• “Create 5 new client onboarding projects from the Client Template”
• “Copy the Sprint Retrospective project for this week”

---

OpenAPI Codegen

Use our generator to build MCP tools from any OpenAPI spec — not just Taskade.

npm install --save-dev @taskade/mcp-openapi-codegen @readme/openapi-parser

import { dereference } from '@readme/openapi-parser';
import { codegen } from '@taskade/mcp-openapi-codegen';

const document = await dereference('your-api-spec.yaml');

await codegen({
  path: 'src/tools.generated.ts',
  document,
});

Works with any OpenAPI 3.0+ spec. Generate MCP tools for your own APIs in minutes.

---

What is Taskade?

Taskade (Y Combinator S19) is the AI-native workspace for building apps, deploying agents, and automating workflows — from a single prompt. 150,000+ apps generated. Trusted by 3M, Nike, Tesla, Netflix, Airbnb, Disney, Adobe. Rated 4.8/5 across 9,300+ reviews.

• Genesis Apps — Build complete apps from prompts. Dashboards, CRMs, portals, forms — deployed instantly. Try it →
• AI Agents — Custom agents with 22+ tools, persistent memory, multi-agent teams, public embedding
• Automations — No-code workflow automation with 100+ integrations, branching, looping, filtering
• Real-time Collaboration — Multiplayer workspace with chat, video, 7 project views
• Templates — 700+ templates for project management, engineering, marketing, and more
• API & MCP — REST API v2, this MCP Server, Agent API, webhooks, OAuth 2.0

Links:

• App: taskade.com
• Create: taskade.com/create
• Agents: taskade.com/agents
• Templates: taskade.com/templates
• Community: taskade.com/community
• Developer Docs: docs.taskade.com
• Workspace MCP guide: https://github.com/taskade/docs/blob/main/apis-living-system-development/workspace-mcp.md
• Genesis App MCP guide (a different, hosted surface): https://github.com/taskade/docs/blob/main/apis-living-system-development/genesis-app-mcp.md
• Blog: taskade.com/blog

---

Roadmap

See open issues for planned features and improvements.

Recently shipped (v0.1.0): Agent chat (promptAgent) and webhook triggers, live now via the Taskade API v2 tool layer.

• Automation & Flow Tools — Create, enable, and manage workflow automations via MCP
• agent.js — Open-source autonomous agent toolkit (coming soon)
• TaskOS — Agent platform at docs.taskade.com

---

Privacy & Security

Your Taskade API token authorizes the MCP server to call the Taskade public API on your behalf. The server talks only to https://www.taskade.com/api/v1 and does not send your data to other third-party services.

• Privacy — see the Taskade Privacy Policy.
• Security & vulnerability reporting — see SECURITY.md.
• Store your token in an environment variable; never commit it.

---

Contributing

Help us improve MCP tools, OpenAPI workflows, and agent capabilities.

• Issues — Report bugs or request features
• Pull Requests — Contributions welcome
• Community — Join the Taskade community
• Contact — [email protected]

---

More from Taskade

• Taskade Docs (source) — developer documentation and API reference
• Integration Kit — open-source Zapier/n8n actions & triggers
• Taskade — platform home, including Genesis, the AI app builder

---

License

MIT