Connect Claude to your tasks
This API answers MCP as well as GraphQL. Give Claude the URL below, sign in, and approve what it asks for — nothing else has to be registered by hand.
The URL
https://tasks-api.hayes2.com/mcp
It has to be this URL exactly. Tokens issued for this API name it, and an address it is not reached by refuses them.
Claude on the web, desktop or mobile
- Open Settings → Connectors.
- Choose Add custom connector and paste the URL above.
- Press Connect, sign in, and approve the access it asks for.
Claude Code
claude mcp add --transport http mainframe-tasks https://tasks-api.hayes2.com/mcp
Then run /mcp inside Claude Code and pick this server to sign in. Add --scope user to the command to have it
available in every project rather than just this one.
What you are approving
Signing in shows a consent screen naming the client and everything it asked for:
| Access | What it means |
|---|---|
tasks:read | Read your projects and tasks |
tasks:write | Add, edit, complete and delete tasks |
offline_access | Stay connected without signing in again every hour |
Approving is what grants anything. Registering a client on its own grants nothing.
What Claude can do once connected
| Tool | Needs | What it does |
|---|---|---|
Projects - Listprojects_list | tasks:read | The projects tasks are filed under, and how many are active in each |
Tasks - Listtasks_list | tasks:read | Tasks, narrowed by view, project, label, status or a search |
Task - Createtask_create | tasks:write | One line of quick-add text: Book the MOT p1 #Home @errand |
Task - Updatetask_update | tasks:write | Title, notes, project, priority, due date, repeat |
Task - Completetask_complete | tasks:write | Marks it done; a repeating task moves to its next occurrence |
Task - Reopentask_reopen | tasks:write | Puts a completed task back on the list |
Task - Deletetask_delete | tasks:write | Deletes it and its subtasks |
Claude is only offered the tools your approval covers, and the API enforces the same scopes on every operation — so an approval that covers reading cannot change anything by any route.
Managing or removing access
Every connection shows up under Connected apps on your account page. Disconnecting one there signs it out and forgets the approval, so it has to be approved again rather than quietly reconnecting.
If it will not connect
- Check the URL ends in
/mcp. The address without it is this page. - A connector added before you had access to this API will keep failing until you remove it and add it again.
- If Claude can see your tasks but cannot change them, the approval covered
tasks:readonly — disconnect it on your account page and connect again.