The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Taskade MCP listing page.
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.
62 tools for workspaces, projects, tasks, AI agents, agent chat, webhooks, knowledge bases, templates, media, and sharing — all from your AI client.
MCP-powered Taskade agent running inside Claude Desktop by Anthropic:
| Build Agents via MCP | Automate Workflows | Manage Projects |
|---|---|---|
![]() | ![]() | ![]() |
| Create, train, deploy AI agents from Claude/Cursor | Build multi-step automations across 100+ services | Full workspace management from your AI assistant (paid plans; some endpoints gated on free) |
⚡ Prefer a hosted option?
https://www.taskade.com/mcpis 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).
Taskade speaks MCP through three surfaces — this repo is the first one:
| I want to… | Use | Where / auth |
|---|---|---|
| Have my AI client read & write my projects, tasks, agents | Workspace MCP — this repo (@taskade/mcp-server) | Local stdio · personal token · most plans |
| Edit my published app's code from my IDE | Genesis App MCP | Hosted · OAuth 2.0 (https://www.taskade.com/mcp) · Business+ |
| Let my agents reach Slack / Shopify / Gmail | MCP Connectors | Hosted, in-product |
Go to Taskade Settings > API and create a Personal Access Token.
Add to your claude_desktop_config.json:
Add to your Cursor MCP settings:
Add to ~/.codeium/windsurf/mcp_config.json (or Settings → Cascade → MCP → Add Server):
In VS Code, open the Cline MCP Servers panel → Configure MCP Servers and add:
Add a .vscode/mcp.json to your workspace (VS Code uses the servers key; ${input:…} prompts for your key on first run):
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.
| Tool | Description |
|---|---|
workspacesGet | List all workspaces |
workspaceFoldersGet | List folders in a workspace |
workspaceCreateProject | Create a project in a workspace |
| 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 |
| 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 |
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 |
| Tool | Description |
|---|---|
folderProjectTemplatesGet | List available project templates |
projectFromTemplate | Create a project from a template |
| Tool | Description |
|---|---|
mediasGet | List media files in a folder |
mediaGet | Get media details |
mediaDelete | Delete a media file |
| Tool | Description |
|---|---|
meProjectsGet | List all your projects |
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 |
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.
| 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 yesterday's completed work" | Reads task history → generates standup summary |
| 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 |
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.
Problem: Team standup notes scattered across Slack, email, and docs.
Problem: You have docs scattered across files and need an AI agent trained on them.
Problem: Creating sprint projects manually every two weeks.
Problem: You need an agent that monitors competitors and reports findings.
Problem: Each new client needs the same project structure, tasks, and materials.
Ask your AI assistant to manage your Taskade workspace:
Build and deploy AI agents directly from your editor:
Automate project creation from templates:
Use our generator to build MCP tools from any OpenAPI spec — not just Taskade.
Works with any OpenAPI 3.0+ spec. Generate MCP tools for your own APIs in minutes.
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.
Links:
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.
agent.js — Open-source autonomous agent toolkit (coming soon)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.
Help us improve MCP tools, OpenAPI workflows, and agent capabilities.
MIT