# Acme Todo

> Acme Todo is an open-source MCP server for productivity. MCP server exposing a simple todo list CRUD API to AI clients over streamable HTTP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted
- **Repository:** https://github.com/ritza-co/acme-todo
- **MCP Registry name:** com.ritzademo/acme-todo
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Flask implementation of a simple todo REST API defined in an OpenAPI file. Todos have a title, a completion flag and an optional due date in YYYY-MM-DD format, and the server exposes create, list, fetch, replace, partial update and delete operations on them.

The registry entry lists a streamable HTTP endpoint for the MCP interface, so an AI client can manage the same todo items as a tool rather than through raw HTTP calls. The repository also documents running the Flask app locally on port 5000 with curl examples for each endpoint.

It suits developers who want a small, readable example of a todo service wired to MCP, or who need a minimal task store to test agent workflows against.

## Features

- **Full todo CRUD:** Create, list, fetch, replace, partially update and delete todo items.
- **Completion tracking:** Each todo carries a boolean completed flag that defaults to false.
- **Optional due dates:** Todos can include a due date stored in YYYY-MM-DD format.
- **Local Flask server:** The API runs as a Flask app that the README starts on localhost port 5000.
- **Streamable HTTP transport:** The registry entry lists a streamable HTTP remote for MCP clients.

## Good for

- Testing an AI agent's ability to create and update tasks
- Prototyping a todo backend exposed to MCP-compatible clients
- Learning how a REST API maps onto MCP tools
- Giving an assistant a simple task list to read and mark complete

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http acme-todo https://mcp.ritzademo.com/mcp/ritza-rzx-our91
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.ritzademo.com/mcp/ritza-rzx-our91
```

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

```json
{
  "mcpServers": {
    "acme-todo": {
      "url": "https://mcp.ritzademo.com/mcp/ritza-rzx-our91"
    }
  }
}
```

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

```json
{
  "servers": {
    "acme-todo": {
      "type": "http",
      "url": "https://mcp.ritzademo.com/mcp/ritza-rzx-our91"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "acme-todo": {
      "serverUrl": "https://mcp.ritzademo.com/mcp/ritza-rzx-our91"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "acme-todo": {
      "type": "http",
      "url": "https://mcp.ritzademo.com/mcp/ritza-rzx-our91"
    }
  }
}
```

## FAQ

### What data does each todo contain?

According to the README, a todo has an read-only integer id, a required string title, a boolean completed flag that defaults to false, and an optional dueDate string in YYYY-MM-DD format.

### How do I run the server locally?

The README says to install the requirements with pip, then run python app.py, which starts the server on http://localhost:5000.

### Which HTTP methods does the API support?

The README lists GET, POST, PUT and PATCH on /todos and /todos/{id}, plus DELETE on /todos/{id}.

### Is Acme Todo free?

Yes. Acme Todo is open source, so you can use and self-host it for free.

### How do I add Acme Todo to Claude Code?

Run this command in your terminal: claude mcp add --transport http acme-todo https://mcp.ritzademo.com/mcp/ritza-rzx-our91

### What are the best alternatives to Acme Todo?

The closest alternatives to Acme Todo are todo.vu, Microsoft Todo MCP Server, ultra-e2e-test tasks, MCP Microsoft Todo and To-do Calendar.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [todo.vu](https://ai-powered.com/mcp/todo-vu): todo.vu is an MCP server for productivity.
- [Microsoft Todo MCP Server](https://ai-powered.com/mcp/microsoft-todo-mcp-server): Microsoft Todo MCP Server is an open-source MCP server for productivity.
- [ultra-e2e-test tasks](https://ai-powered.com/mcp/ultra-e2e-test-tasks): ultra-e2e-test tasks is an open-source MCP server for productivity.
- [MCP Microsoft Todo](https://ai-powered.com/mcp/mcp-microsoft-todo): MCP Microsoft Todo is an open-source MCP server for productivity.
- [To-do Calendar](https://ai-powered.com/mcp/to-do-calendar): To-do Calendar is an MCP server for productivity.
- [Tasks Example](https://ai-powered.com/mcp/tasks-example): Tasks Example is an MCP server for productivity.
- [Todo MCP](https://ai-powered.com/mcp/todo-mcp-2): Todo MCP is an open-source MCP server for productivity.
- [doing](https://ai-powered.com/mcp/doing): doing is an MCP server for productivity.

---
Source: https://ai-powered.com/mcp/acme-todo
