Taskade MCP Server

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 browse your workspace as a virtual file system, read projects, agents, and automations, and even edit Genesis app source code directly.

🔬 Beta: The hosted Taskade MCP server (v6.148.0+) is in beta. You can also use the open-source @taskade/mcp-server npm package for a self-hosted option with 50+ tools.

💡 Note: Looking to use external MCP servers inside Taskade? See MCP Connectors instead.

Two Ways to Connect

Taskade offers two MCP server options:

Hosted MCP Server (Beta)

The hosted MCP server gives your AI tools direct access to your workspace through a Virtual File System (VFS). Each workspace appears as a browsable file system with five directories:

Plan Requirements

The hosted MCP server is available on Business ($40/mo), Max ($200/mo), and Enterprise ($400/mo) plans. Free, Starter, and Pro plans do not include hosted MCP access. You can still use the open-source @taskade/mcp-server package on any plan.

Authentication

The hosted server uses OAuth 2.0 with PKCE — fully standards-compliant. When you connect from Claude Desktop, Cursor, or another MCP client, Taskade will open a browser window for you to authorize access. No manual API key setup is needed.

Connect from Claude Desktop

Add this to your Claude Desktop config file (claude_desktop_config.json):

{
  "mcpServers": {
    "taskade": {
      "type": "url",
      "url": "https://app.taskade.com/mcp"
    }
  }
}

Restart Claude Desktop. It will open a browser window to authorize Taskade. Once approved, your workspace tools appear in the tools menu.

Connect from Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "taskade": {
      "type": "url",
      "url": "https://app.taskade.com/mcp"
    }
  }
}

Connect from Any MCP Client

Any client that supports the MCP protocol with OAuth 2.0 can connect to the hosted server at:

https://app.taskade.com/mcp

The server publishes OAuth metadata at the standard well-known endpoints for automatic discovery.

Available Tools (Hosted)

The hosted MCP server provides three core tools:

How write_file works: You can create new files, replace strings, insert lines, or apply unified diff patches to files in the app/ directory. Always read a file with inspect_space before editing to avoid overwriting changes.

Open-Source MCP Server

The open-source @taskade/mcp-server npm package provides 50+ tools across 7 categories. It runs locally on your machine and connects to Taskade via a Personal Access Token.

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 (Open-Source)

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 (Open-Source)

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 (Open-Source)

The open-source MCP server exposes 50+ tools organized into 7 categories:

Workspaces

Projects

Tasks

AI Agents

Templates, Media & Personal

Use Cases

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. This is only needed for the open-source MCP server — the hosted server uses OAuth 2.0 instead.

Which plans include the hosted MCP server?

Business ($40/mo), Max ($200/mo), and Enterprise ($400/mo). The open-source @taskade/mcp-server npm package works on any plan with 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 edit my Genesis app code via MCP?

Yes. The hosted MCP server's write_file tool lets you create, edit, and patch files in the app/ directory. You need Collaborator, Maintainer, or Owner role in the workspace.

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.

Related guides

• MCP Connectors (Genesis) — Connect Claude Desktop, Cursor, and any MCP client from inside Taskade
• Developer API · Public API — Other programmatic entry points
• Tools for AI Agents — How agents use MCP tools
• Custom AI Agents — Enable MCP tools on specific agents
• GitHub: taskade/mcp