✨/Docs
Open app

MCP server

The Model Context Protocol (MCP) server provides a standardized interface that lets any compatible AI client — such as ChatGPT, Claude, Cursor, or Manus — securely access your Taskaid data in a simple and controlled way. It is centrally hosted by Taskaid and authenticated with OAuth 2.1, so there's no API key to manage: you sign in and approve the access you want to grant.

What you can do

Once connected and authorized, your client can, on your behalf and within the scopes you approve:

  • Tasks & lists — view your active tasks, create and update tasks, and organize them into lists.
  • Daily plan — read and write the plan that appears at the top of your Taskaid home.

Connect

ChatGPT installs Taskaid from its Apps directory — no URL to enter. Every other client adds the remote server by its URL — https://taskaid.ai/mcp (use taskaid as the server name); if a client doesn't support remote MCP servers natively, use the mcp-remote bridge shown under "Any other client."

ChatGPT

Taskaid is published in the ChatGPT Apps directory — install it in a couple of clicks, no URL needed. See the dedicated ChatGPT guide for the full walkthrough.

Claude (web, desktop & Claude Code)

At claude.ai/customize/connectors, add a custom connector with the endpoint:

https://taskaid.ai/mcp

In Claude Code, claude mcp add --scope user --transport http taskaid https://taskaid.ai/mcp, then /mcp to authenticate. Custom connectors work on every Claude plan, including Free. See the dedicated Claude guide for the full walkthrough.

Cursor

In Cursor's MCP settings, add a new server and enter the endpoint:

https://taskaid.ai/mcp

Manus

In Manus, open Settings → Connectors and use the Create menu. Either route works; the first has fewer fields.

Add MCP by URL — enter a Server name of Taskaid and a Server URL of https://taskaid.ai/mcp, then select Save. Leave Advanced settings alone.

Custom MCP — the fuller form, worth it if you want an icon or a note on the connector. Same name and URL, with Transport Type set to HTTP and Custom headers left empty.

Either way there is nothing to paste for authentication: Taskaid uses OAuth, so there is no API key or bearer token — you sign in and approve the access instead.

Any other client

Any MCP-capable client connects to https://taskaid.ai/mcp. If yours doesn't yet support remote MCP servers natively, use the mcp-remote compatibility bridge:

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

Authentication & permissions

Taskaid uses OAuth 2.1 with dynamic client registration — there is no API key. On first connect, your browser opens, you sign in, and you approve the scopes being requested. Tokens are limited to those scopes, and you can revoke access anytime by disconnecting the server in your client.

Some clients don't request scopes explicitly. Taskaid then asks for the four task and plan scopes below; offline_access is granted only when a client asks for it.

  • tasks:read — view tasks and lists.
  • tasks:write — create and update tasks and lists.
  • plans:read — view the daily plan.
  • plans:write — write the daily plan.
  • offline_access — refresh access without re-authenticating.

Tools

save_* tools are upserts: omit id to create, pass id to update. Read-only tools never modify your data.

Tasks & lists

  • view_tasks (read) — list your active tasks; optional listId, query and limit (query matches every word against a task's name or note).
  • save_task (write) — create a task (omit id) or update one (pass id): name, note, due date, list, duration, starred, completed.
  • view_lists (read) — list your task lists.
  • save_list (write) — create a list, or rename / change the emoji on an existing one.

Daily plan

  • view_daily_plan (read) — read the plan for a day.
  • set_daily_plan (write) — write or replace a day's plan (markdown; renders at the top of /home).

Example prompts

  • "Pull my Taskaid tasks for today and group them by list."
  • "Add a task to draft the Q3 report, due tomorrow, and star it as important."
  • "Read my tasks for today, then write me a focused daily plan."

Security & privacy

  • Access is limited to the scopes you approve, and every action runs as your own account.
  • Taskaid only accesses the data needed to fulfill a request. It does not read your AI client's other conversations, memory, or uploaded files, and your data is never used to train AI models.
  • See our Privacy Policy and Terms of Service for details.
  • Revoke access anytime by removing the Taskaid server in your client.

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 doesn't appear — restart your client and confirm the URL is exactly https://taskaid.ai/mcp.
  • Stuck auth — clear your client's saved MCP auth (for the mcp-remote bridge, remove ~/.mcp-auth) and reconnect.