✨ taskaid/Docs/AI/MCP server
Open app

MCP server

Connect Taskaid to Claude Code, Claude Desktop, Cursor, or any MCP-compatible client. Once connected, your assistant can read your active tasks, create tasks, and manage task lists with your permission.

Before you start

  • You need a Taskaid account.
  • Your MCP client must support remote HTTP servers or an mcp-remote bridge.
  • Sign in with Google when the client opens the Taskaid authorization page.

Endpoint

https://taskaid.ai/mcp

Use the name taskaid when your client asks for a server label.

Install in Claude Code

Run this once from your terminal:

claude mcp add --transport http --scope user taskaid https://taskaid.ai/mcp

Then run /mcp in any Claude Code session to authenticate.

Install in Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "taskaid": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://taskaid.ai/mcp"]
    }
  }
}

Restart Claude Desktop. The first request will open a browser tab to authenticate.

Install in Cursor

Cursor supports remote MCP servers. Add a new MCP server in Cursor settings and use:

https://taskaid.ai/mcp

Tools

After authorization, your assistant can use these tools:

  • view_tasks — lists your active tasks. Can be filtered by listId.
  • create_task — creates a task and verifies list ownership before linking.
  • view_lists — lists your task lists.
  • create_list — creates a new task list.

How auth works

Taskaid uses OAuth. Your MCP client stores a scoped access token locally, then refreshes it through the standard OAuth flow. The token only grants the scopes required for Taskaid MCP tools.

Troubleshooting

  • insufficient_scope — reconnect the server from your client so Taskaid can grant the missing scope.
  • 401 Unauthorized — reconnect the server. Your token may have expired or been revoked.
  • Server does not appear — restart your MCP client and confirm the server URL is exactly https://taskaid.ai/mcp.