# Petodo

> Petodo is a free MCP server for productivity. Reach your Petodo to-do list from Claude Code, Claude Desktop or Cursor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, Windows, macOS, iOS
- **Website:** https://petodoapp.com
- **Repository:** https://github.com/gaby3637/petodo-cli
- **MCP Registry name:** io.github.gaby3637/petodo
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

Petodo is a desktop pet that sits on top of your windows and holds your to-do list, and this package is its command-line and MCP bridge. It talks to the same list over the network, so tasks added by an assistant show up in the app immediately, whether or not the app is running on the machine you are using.

An assistant can list, add, complete, edit, delete and summarise tasks. Times written in a title are understood, so adding call Sam 2pm schedules it for 2pm, and phrases like every weekday at 6pm create repeating tasks. The same command line offers petodo report for what is overdue, due soon and your streak.

Sign-in prints a short code and opens the browser. The token is stored readable only by you and petodo logout revokes it. API keys can be created for other tools and reach the list only. It needs Node 18 or newer and has no dependencies.

## Features

- **Natural time parsing:** Reads times such as 2pm or tomorrow 9am from the task title.
- **Repeating tasks:** Phrases like every weekday create rules that show one day at a time.
- **One-line client setup:** petodo connect registers it with Claude Code, Claude Desktop or Cursor.
- **Progress report:** Shows overdue and upcoming tasks and your streak.
- **Scoped API keys:** Keys can reach the list and nothing else.
- **Device-code sign-in:** Matching codes in terminal and browser guard against stray sign-ins.

## Good for

- Add tasks by voice-like phrasing from a chat with an assistant
- Mark tasks done from the terminal
- Ask an assistant what is overdue
- Create recurring reminders such as a weekday gym slot

## Install

### Claude Code (Terminal)

```sh
claude mcp add petodo -- npx -y petodo-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "petodo": {
      "command": "npx",
      "args": [
        "-y",
        "petodo-cli"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "petodo": {
      "command": "npx",
      "args": [
        "-y",
        "petodo-cli"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "petodo": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "petodo-cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "petodo": {
      "command": "npx",
      "args": [
        "-y",
        "petodo-cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "petodo": {
      "command": "npx",
      "args": [
        "-y",
        "petodo-cli"
      ]
    }
  }
}
```

## FAQ

### What does it need?

Node 18 or newer; there are no dependencies.

### Where is my token kept?

In ~/.petodo/config.json, readable only by you; petodo logout revokes it.

### Which assistants can it connect to?

petodo connect supports claude-code, claude-desktop and cursor.

### Is the Petodo app free?

The site describes the desktop app as free for Windows and Mac.

### Is Petodo free?

Yes. Petodo is free to use.

### How do I add Petodo to Claude Code?

Run this command in your terminal: claude mcp add petodo -- npx -y petodo-cli

### What are the best alternatives to Petodo?

The closest alternatives to Petodo are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/petodo
