Updated November 11, 2026
The Model Context Protocol lets an assistant like Claude call tools on your behalf. A to-do MCP server gives it tools for your task list: list what is open, add a task, tick one off, move it, delete it, and summarise what is overdue. Petodo's lives in the petodo-cli package on npm, with no dependencies, and needs Node 18 or newer.
1. Sign in
npx petodo-cli login
This prints a short code and opens your browser. Check that the code on screen matches the one in the terminal before you approve it; that is what stops someone else's sign-in attempt landing in your account. The token is saved to ~/.petodo/config.json, readable only by you. petodo logout revokes it and removes the file.
If you will use it more than once, install it properly so the command is just petodo:
npm install -g petodo-cli
2. Connect your assistant
One command registers the server, merging into whatever is already configured rather than replacing it:
petodo connect claude-code
petodo connect claude-desktop
petodo connect cursor
- Claude Code: the command asks Claude Code to add it for you. If the
claudecommand is not on your path, it prints the line to run yourself:claude mcp add petodo -s user -- npx -y petodo-cli mcp. - Claude Desktop: it edits
claude_desktop_config.json(in~/Library/Application Support/Claudeon a Mac,%APPDATA%\Claudeon Windows). Restart Claude Desktop afterwards. - Cursor: it edits
~/.cursor/mcp.json. Restart Cursor afterwards.
Prefer to paste it yourself? petodo connect --print prints the entry:
{
"mcpServers": {
"petodo": {
"command": "npx",
"args": ["-y", "petodo-cli", "mcp"]
}
}
}
3. Ask for things in plain words
The assistant now has six tools: list_tasks, add_task, complete_task, update_task, delete_task and get_report. You do not need to name them. Try:
- “Add ‘review the PR 4pm’ to my list.”
- “What's overdue, and what is due in the next hour?”
- “Move the dentist to tomorrow and mark ‘send the invoice’ done.”
- “Set up ‘standup every weekday at 9:30am’.”
Times in a title are read for you, exactly as when you type them into Petodo, so “call Sam 2pm” from Claude gets its time and its reminders. Repeats like “gym every weekday at 6pm” become a repeating task.
The same list from the terminal
The package is also a plain command line, handy in scripts and for quick capture:
petodo add "call Sam 2pm"
petodo list --today
petodo done 4f2a # an id prefix, or part of the title
petodo edit 4f2a --due "3pm"
petodo report
Assistants that speak HTTP
For an assistant that calls an HTTP API rather than MCP, make it its own key:
petodo keys create "Claude"
petodo keys list
petodo keys revoke <id>
A key reaches the list and nothing else. Revoke it and only that assistant loses access. In the desktop app, Settings, Account and sync, Set up an assistant makes a key and copies everything the assistant needs.
Why put an assistant on this list
Because the list does not stay in a tab. Whatever Claude adds shows up on the pet on your screen, gets its reminders, and comes to find you when it is due. And if you run agents on Telegram, Petodo can hand them errands at a set time too: how agent hand-off works.