Guide

A to-do MCP server for Claude, in three commands.

petodo-cli is a command line and an MCP server in one. Sign in once, register it with Claude Code, Claude Desktop or Cursor, and your assistant can read and change the same list your pet holds.

Free · Windows 10 and 11 · macOS 11 and later · version 1.0.9

Retro Bot, a Petodo desktop pet, telling you an assistant added a task

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 claude command 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/Claude on a Mac, %APPDATA%\Claude on 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.

Questions people ask

Does the Petodo app need to be running?

No. The MCP server talks to your list on Petodo's server, so the assistant's changes land straight away and your devices pick them up on their next sync. The pet mentions what was added.

What can the assistant not do?

Anything except the list. It cannot read your email address, make another key, add or remove devices, change Telegram, Pavlok or nagging settings, or touch billing.

Which time zone does it use?

Yours. Times in a title, like “2pm”, are read in your own clock on the machine running the server, the same way your typing is.

Is it free?

The package is free and MIT-licensed. Assistant access uses your Petodo account; one assistant key is free, and Pro covers as many as you like.

Give your to-do list somewhere to live.

Free, no account, and it takes about a minute to set up.