Overview
The Taskade MCP server lets you connect your Taskade workspace to any MCP-compatible AI tool — Claude Desktop, Cursor, Windsurf, VS Code, and more. Once connected, your AI assistant can manage projects, create tasks, chat with agents, and access your workspace data directly.
The server provides 50+ tools across 7 categories, giving external AI tools full access to your workspace.
💡 Note: Looking to use external MCP servers inside Taskade? See MCP Connectors instead.
Installation
Prerequisites
- Node.js 18+ installed
- A Taskade Personal Access Token — generate one at Settings → Developer
Quick Start
Run the MCP server with npx (no install needed):
npx -y @taskade/mcp-server
Or install globally:
npm install -g @taskade/mcp-server
Connect to Claude Desktop
Add this to your Claude Desktop config file (claude_desktop_config.json):
{
"mcpServers": {
"taskade": {
"command": "npx",
"args": ["-y", "@taskade/mcp-server"],
"env": {
"TASKADE_API_KEY": "your-api-key-here"
}
}
}
}
Restart Claude Desktop. You should see Taskade tools available in the tools menu.
Connect to Cursor
Add to your Cursor MCP settings (.cursor/mcp.json):
{
"mcpServers": {
"taskade": {
"command": "npx",
"args": ["-y", "@taskade/mcp-server"],
"env": {
"TASKADE_API_KEY": "your-api-key-here"
}
}
}
}
Connect via HTTP/SSE (n8n, Custom Clients)
For HTTP-based MCP clients, start the server in HTTP mode:
TASKADE_API_KEY=your-api-key npx @taskade/mcp-server --http
The server starts on localhost:3000. Connect your client to the SSE endpoint:
http://localhost:3000/sse?access_token=your-api-key
Available Tools
The MCP server exposes 50+ tools organized into 7 categories:
Workspaces
| Tool | Description |
|---|---|
| List Workspaces | Get all workspaces you have access to |
| List Folders | Get folders in a workspace |
| Create Project | Create a new project in a workspace |
Projects
| Tool | Description |
|---|---|
| Get Project | Retrieve a project by ID |
| Create Project | Create a new project |
| Copy Project | Duplicate an existing project |
| Complete / Restore | Mark a project complete or restore it |
| From Template | Create a project from a template |
| Get Members | List project members |
| Get Fields | List custom fields |
| Get/Enable Share Link | Manage project share links |
| Get Blocks | Get project content blocks |
| Get Tasks | List all tasks in a project |
Tasks
| Tool | Description |
|---|---|
| Full CRUD | Create, read, update, delete tasks |
| Complete / Uncomplete | Toggle task completion |
| Move | Move tasks between projects |
| Assignees | Add or remove task assignees |
| Dates | Set due dates and reminders |
| Notes | Add or update task notes |
| Custom Fields | Set custom field values |
AI Agents
| Tool | Description |
|---|---|
| Create Agent | Create a new AI agent in a folder |
| Generate Agent | Generate an agent with AI from a description |
| Get / Update / Delete | Manage agent settings |
| Public Access | Enable or disable public access |
| Knowledge | Add or remove projects and media from agent knowledge |
| Conversations | List and retrieve agent conversations |
Templates, Media & Personal
| Tool | Description |
|---|---|
| List Templates | Get project templates in a folder |
| Create from Template | Generate a project from a template |
| List / Get / Delete Media | Manage uploaded media files |
| My Projects | List your personal projects |
Use Cases
| Use Case | Example |
|---|---|
| Coding assistant | Ask Claude to create tasks in your sprint board as you work |
| Meeting follow-ups | Have your AI assistant create project tasks from meeting notes |
| Agent management | Create and configure AI agents from your IDE |
| Knowledge updates | Add documents to agent knowledge bases without leaving your editor |
| Project reporting | Query project status, task completion, and team assignments |
OpenAPI Codegen
The Taskade MCP monorepo also includes @taskade/mcp-openapi-codegen — a tool that generates MCP-compatible tools from any OpenAPI 3.0+ specification. This lets you create MCP servers for your own APIs.
npx @taskade/mcp-openapi-codegen --spec https://api.example.com/openapi.json
Frequently Asked Questions
Where do I get my API key?
Go to Settings → Developer and create a Personal Access Token.
Which AI tools support MCP?
Claude Desktop, Cursor, Windsurf, VS Code (with MCP extension), n8n, and any tool that supports the Model Context Protocol.
Can I use this with AI agents inside Taskade?
This server is for connecting external AI tools to Taskade. To use MCP servers inside Taskade, see MCP Connectors.