✨ taskaid/Docs/AI/MCP server
Open app

Taskaid MCP server

The Model Context Protocol (MCP) server provides a standardized interface that lets any compatible AI client — such as ChatGPT, Claude, or Cursor — 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 with Google 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.
  • Calendar — view your day, block time, and reschedule or clear events.
  • 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)

In Settings → Connectors, add a custom connector and enter the endpoint:

https://taskaid.ai/mcp

Your browser opens to sign in with Google and approve access.

Claude Code

Add the server once, then run /mcp in any session to authenticate:

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

Cursor

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

https://taskaid.ai/mcp

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 with Google, and you approve the scopes the client requests. Tokens are limited to those scopes, and you can revoke access anytime by disconnecting the server in your client.

  • tasks:read — view tasks and lists.
  • tasks:write — create and update tasks and lists.
  • events:read — view calendar events.
  • events:write — create, update, and delete calendar events.
  • 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 filter.
  • 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.

Calendar

  • view_events (read) — events for a day (defaults to today); includes the linked task for time-blocks.
  • save_event (write) — create or reschedule an event, standalone or as a time-block on a task.
  • delete_event (write) — remove a calendar event (the underlying task is kept).

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."
  • "Block 2–3pm today on my calendar for focused writing."
  • "Read my tasks and events 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.