MCP Setup
The todo.ac MCP server lets AI assistants (Claude, etc.) read and manage your todos, goals, and vision.
Connect in Claude
- Open Claude → Settings → Integrations
- Add MCP server URL:
https://mcp.todo.ac/sse - Authorise with your GitHub account when prompted
Once connected, Claude can list, create, update, and delete your todos and goals.
Available Tools
| Tool | Description |
|---|---|
list_todos | List todos with optional filters |
get_todo | Fetch a single todo by ID |
create_todo | Create a new todo |
update_todo | Update a todo's fields |
delete_todo | Delete a todo |
reorder_todo | Change a todo's position |
bulk_tag_todos | Add or remove tags across multiple todos |
list_goals | List goals |
get_goal | Fetch a single goal by ID |
create_goal | Create a new goal |
update_goal | Update a goal |
delete_goal | Delete a goal |
reorder_goal | Change a goal's position |
bulk_tag_goals | Add or remove tags across multiple goals |
get_vision | Fetch your vision statement |
update_vision | Update your vision statement |
Session Expiry
MCP sessions use a JWT that expires after 1 hour, with a refresh token valid for 30 days. If your session expires, reconnect by visiting mcp.todo.ac and re-authorising.