Allows AI assistants to manage your Petodo to-do list by listing, adding, completing, editing, and reporting on tasks.
Also known as gaby3637/petodo-cli, petodo-cli
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.1.1
- Last commit
- Nov 11, 2026
- License
- MIT
What is Petodo MCP?
Petodo allows AI assistants to manage your Petodo to-do list by listing, adding, completing, editing, and reporting on tasks.
Summary generated from the project's README
About Petodo MCP server
Managing your Petodo to-do list through AI assistants like Claude Desktop, Claude Code, or Cursor is what this MCP server enables. It allows an AI to interact with your tasks over a network, meaning the desktop pet application does not need to be running on the same machine you are using to chat with the assistant. Users can set up the connection using the petodo connect command to register the server with their preferred client.
Developers and task managers can use the assistant to list, add, complete, edit, delete, and summarize tasks. The server handles natural language time expressions, such as scheduling a task for 2pm or setting up repeating daily gym sessions. For those requiring specific access, the system supports creating individual API keys that grant task access without exposing sensitive account details like email addresses. The setup requires Node 18 or newer and uses a local config file for authentication.
What you can do with it
- 1Schedule tasks with natural languageAsk your AI assistant to add a new task including a specific time like 2pm.
- 2Manage recurring daily responsibilitiesInstruct the assistant to create a repeating task for a specific schedule.
- 3Review task progress and streaksRequest a summary of overdue items and your current productivity streak.
- 4Update existing task detailsHave the assistant change the due date or title of a specific task using its ID.
Written from the project's README. Every use case is checked against a quote from it.
How to install Petodo MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Petodo MCP in Claude Code
$ claude mcp add petodo-cli -- npx -y petodo-cliInstall Petodo MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"petodo-cli": {
"command": "npx",
"args": [
"-y",
"petodo-cli"
]
}
}
}Install Petodo MCP in VS Code
.vscode/mcp.json
{
"servers": {
"petodo-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"petodo-cli"
]
}
}
}Install Petodo MCP in VS Code CLI
$ code --add-mcp '{"name":"petodo-cli","type":"stdio","command":"npx","args":["-y","petodo-cli"]}'Install Petodo MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"petodo-cli": {
"command": "npx",
"args": [
"-y",
"petodo-cli"
]
}
}
}Install Petodo MCP in Codex
$ codex mcp add petodo-cli -- npx -y petodo-cliInstall Petodo MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.petodo-cli] command = "npx" args = ["-y", "petodo-cli"]
Install Petodo MCP in Gemini CLI
$ gemini mcp add -s user petodo-cli npx -- -y petodo-cliInstall Petodo MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"petodo-cli": {
"command": "npx",
"args": [
"-y",
"petodo-cli"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablegaby3637/petodo-cli is public and reachablegithub.com/gaby3637/petodo-cli ↗Pass
- Package names this repository as its sourcepetodo-cli names gaby3637/petodo-cli as sourcenpmjs.com/package/petodo-cli ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/gaby3637/petodo-cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from petodo-cliPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubpetodo-cli
Your Petodo to-do list from the terminal: and an MCP server, so Claude Code, Claude Desktop and Cursor can work the same list directly.
Petodo itself is a desktop pet that holds your to-do list. This is the same list, reached over the network, so it works whether or not the app is running on the machine you are typing on.
npx petodo-cli login
npx petodo-cli add "call Sam 2pm"
Install it properly if you use it more than once:
npm install -g petodo-cli
petodo list
Node 18 or newer. No dependencies.
Signing in
petodo login
Prints a short code and opens your browser. Check the code on screen matches the one in the terminal before approving. That is what stops someone else's sign-in attempt landing in your account.
The token is written to ~/.petodo/config.json, readable only by you. petodo logout revokes it and removes the file.
Everyday use
petodo list [--all|--done] [--today|--tomorrow]
petodo add "call Sam 2pm" times in the text are understood
petodo done <id> an id prefix, or part of the title, is enough
petodo undo <id>
petodo rm <id>
petodo edit <id> [--title "..."] [--due "3pm"] [--clear-due] [--today|--tomorrow]
petodo report what is overdue, due soon, and your streak
petodo whoami
Ids are UUIDs and petodo list shows the first eight characters, which is all
you ever need to type. If that is still ambiguous the command says so rather
than guessing:
$ petodo done bbbb
"bbbb" matches 2 tasks. Use more of the id.
Words that name a time are read out of the title in your own clock:
petodo add "call Sam 2pm" files the task for 2pm today and arms the
reminders. Pass --due only when you want to override that.
So are words that mean "again":
$ petodo add "gym every weekday at 6pm"
repeating 4f2a91cc gym
Every weekday at 6:00 PM
first one 6:00 PM
A repeat appears one day at a time. petodo list shows today's with a ↻,
and the rules themselves underneath. petodo done on one finishes that day;
petodo rm on a rule stops it repeating and takes the days still to come.
With an assistant
petodo mcp runs an MCP server on stdin and
stdout. You do not normally run it yourself; you register it once:
petodo connect claude-code # or claude-desktop, or cursor
petodo connect --print # the config, to paste yourself
The assistant can then list, add, complete, edit, delete and summarise your tasks. Everything it does is under your own account and shows up in the app immediately.
For an assistant that wants HTTP 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. It cannot read your email address, make another key, or remove a device. Take one away and only that assistant loses access.
Environment
| Variable | What it does |
|---|---|
PETODO_TOKEN |
Use this token instead of the signed-in one, for this command only. |
PETODO_ENDPOINT |
Point at a different API. Defaults to https://app.petodoapp.com/api. |
PETODO_HOME |
Where the config lives. Defaults to ~/.petodo. |
The environment always wins over the stored config, so a one-off override stays a one-off.
Licence
MIT.
Petodo MCP questions
How do I add Petodo MCP to Claude Code?
Run claude mcp add petodo-cli -- npx -y petodo-cli in your terminal. Add --scope user to make it available in every project.
How do I add Petodo MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How do I connect Petodo to Claude or Cursor?
You can use the command 'petodo connect claude-code', 'petodo connect claude-desktop', or 'petodo connect cursor' to register the server.
How does the authentication process work?
Running 'petodo login' prints a short code and opens your browser for approval, then saves a token to ~/.petodo/config.json.