Sandbox
@taskade/mcp

MCP server for Taskade and OpenAPI APIs

This repo connects AI clients to Taskade through MCP so they can manage workspaces, projects, tasks, agents, templates, media, and webhooks. It also ships OpenAPI codegen so you can generate MCP tools from your own API spec.

164 stars49 forksTypeScriptUpdated 7d ago
Who it's for

Builders who want their agent to manage Taskade content or call APIs through MCP.

What it delivers

You can ask your agent to create projects, update tasks, train agents, and call API-backed tools without writing a custom client.

What it does

Taskade workspace access

Lets AI clients list workspaces, read projects and tasks, create content, and manage sharing from MCP.

AI agent management

Creates, updates, publishes, and trains Taskade agents with projects and media as knowledge.

Agent chat and webhooks

Adds live agent conversation tools and webhook subscription support through the API v2 layer.

OpenAPI code generation

Generates MCP tools from any OpenAPI 3.0+ document with the `@taskade/mcp-openapi-codegen` package.

Client setup examples

Shows config snippets for Claude Desktop, Cursor, Windsurf, Cline, VS Code, and HTTP/SSE mode.

How to get it

  1. 1Run
    TASKADE_API_KEY=your-api-key npx @taskade/mcp-server --http
  2. 2Use our generator to build MCP tools from any OpenAPI spec — not just Taskade.
    npm install --save-dev @taskade/mcp-openapi-codegen @readme/openapi-parser

README

Taskade MCP Server

The Workspace MCP (@taskade/mcp-server) — run your Taskade workspace from any AI client.

Connect Taskade to any AI assistant — Claude, Cursor, Windsurf, VS Code, and more — via the Model Context Protocol.

npm GitHub stars License

Add to Cursor Install in VS Code

62 tools for workspaces, projects, tasks, AI agents, agent chat, webhooks, knowledge bases, templates, media, and sharing — all from your AI client.

  • 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

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 MCPAutomate WorkflowsManage Projects
Create AI agents from your IDE via Taskade MCPAutomate workflows via Taskade MCPManage projects and apps via Taskade MCP
Create, train, deploy AI agents from Claude/CursorBuild multi-step automations across 100+ servicesFull workspace management from your AI assistant (paid plans; some endpoints gated on free)

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:

I want to…UseWhere / auth
Have my AI client read & write my projects, tasks, agentsWorkspace MCP — this repo (@taskade/mcp-server)Local stdio · personal token · most plans
Edit my published app's code from my IDEGenesis App MCPHosted · OAuth 2.0 (https://www.taskade.com/mcp) · Business+
Let my agents reach Slack / Shopify / GmailMCP ConnectorsHosted, in-product

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

ToolDescription
workspacesGetList all workspaces
workspaceFoldersGetList folders in a workspace
workspaceCreateProjectCreate a project in a workspace

Projects

ToolDescription
projectGetGet project details
projectCreateCreate a new project
projectCopyCopy a project to a folder
projectCompleteMark project as completed
projectRestoreRestore a completed project
projectMembersGetList project members
projectFieldsGetGet custom fields for a project
projectShareLinkGetGet the share link
projectShareLinkEnableEnable the share link
projectBlocksGetGet all blocks in a project
projectTasksGetGet all tasks in a project
folderProjectsGetList projects in a folder

Tasks

ToolDescription
taskGetGet task details
taskCreateCreate one or more tasks
taskPutUpdate a task
taskDeleteDelete a task
taskCompleteMark task as complete
taskUncompleteMark task as incomplete
taskMoveMove a task within a project
taskAssigneesGetGet task assignees
taskPutAssigneesAssign users to a task
taskDeleteAssigneesRemove assignees
taskGetDateGet task due date
taskPutDateSet task due date
taskDeleteDateRemove task due date
taskNoteGetGet task note
taskNotePutUpdate task note
taskNoteDeleteDelete task note
taskFieldsValueGetGet all field values
taskFieldValueGetGet a specific field value
taskFieldValuePutSet a field value
taskFieldValueDeleteDelete a field value

AI Agents

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

ToolDescription
folderAgentGenerateGenerate an AI agent from a text prompt
folderCreateAgentCreate an agent with custom configuration
folderAgentGetList agents in a folder
agentGetGet agent details
agentUpdateUpdate agent configuration
deleteAgentDelete an agent
agentPublicAccessEnablePublish agent publicly
agentPublicGetGet public agent details
agentPublicUpdateUpdate public agent settings
agentKnowledgeProjectCreateAdd a project as agent knowledge
agentKnowledgeMediaCreateAdd media as agent knowledge
agentKnowledgeProjectRemoveRemove project from knowledge
agentKnowledgeMediaRemoveRemove media from knowledge
agentConvosGetList agent conversations
agentConvoGetGet conversation details
publicAgentGetGet agent by public ID

Templates

ToolDescription
folderProjectTemplatesGetList available project templates
projectFromTemplateCreate a project from a template

Media

ToolDescription
mediasGetList media files in a folder
mediaGetGet media details
mediaDeleteDelete a media file

Personal

ToolDescription
meProjectsGetList 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.

ToolDescription
promptAgentSend a message to an AI agent and get its reply
listConversationsList an agent's conversations
getConversationGet a conversation's messages
subscribeWebhookSubscribe to real-time Taskade event webhooks
unsubscribeWebhookRemove 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 SayWhat 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 APIMCP Server
SetupWrite HTTP client, handle auth, parse JSONnpx @taskade/mcp-server — one command
InterfaceCode against endpointsNatural language — describe what you need
ChainingManual orchestrationAI chains tools intelligently
Error handlingWrite error handling codeAI 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

Recipe 1: Daily Standup Summarizer

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.
Recipe 2: Knowledge Base Agent Builder

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.
Recipe 3: Sprint Planning Automation

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.
Recipe 4: Competitive Intelligence Agent

Problem: You need an agent that monitors competitors and reports findings.

You: "Generate an AI agent that researches our top 5 competitors.
      Train it on our Competitive Analysis project.
      Name it 'Market Intel Agent'."

Claude uses:
  1. folderAgentGenerate → generate agent from research prompt
  2. agentKnowledgeProjectCreate → connect Competitive Analysis project
  3. agentUpdate → refine instructions for research cadence

Result: AI research agent with domain knowledge, ready for briefings.
Recipe 5: Client Onboarding Pipeline

Problem: Each new client needs the same project structure, tasks, and materials.

You: "For our new client Acme Corp: create a project from
      the 'Client Onboarding' template, add tasks for
      kickoff meeting and SOW review, set due dates for
      the next 2 weeks, then share the project link."

Claude uses:
  1. projectFromTemplate → create "Acme Corp Onboarding"
  2. taskCreate → add kickoff, requirements, SOW tasks
  3. taskPutDate → set dates across next 2 weeks
  4. projectShareLinkEnable → generate share link

Result: Client onboarding project live and shareable in 30 seconds.

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:


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 the Taskade public API — https://www.taskade.com/api/v1 and https://www.taskade.com/api/v2 — and does not send your data to other third-party services.


Contributing

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


More from Taskade


License

MIT

Files in the repo

Repository payload19 top-level entries
  • .changeset
  • .github
  • examples
  • packages
  • .eslintignore
  • .eslintrc.json
  • .gitignore
  • CODE_OF_CONDUCT.md
  • CONTRIBUTING.md
  • Dockerfile
  • glama.json
  • lerna.json
  • LICENSE
  • package.json
  • README.md
  • SECURITY.md
  • smithery.yaml
  • tsconfig.json
  • yarn.lock

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More connectors

Real-time global intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface

86k

High-performance code intelligence MCP server. Indexes codebases into a persistent knowledge graph — average repo in milliseconds. 158 languages, sub-ms queries, 99% fewer tokens. Single static binary, zero dependencies.

43k

Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code

14k
okf-memory/
okf-agent-memory

Git-native persistent memory for AI coding agents. Implements Google OKF v0.2 with sub-300µs in-memory BM25 search, embedded MCP server, and progressive disclosure. Slashes token bloat by 80% with zero external databases or dependencies. Built in pure Go.

547
tirth8205/
code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.

31k
2akouwu/
reverify

Stop your AI from making things up — it proposes, deterministic tools decide, every claim checked against ground truth with evidence. Grounded facts and context survive resets. Reverse engineering is the proving ground. MCP server + CLI.

1.1k