@bazacle/todo-mcp

MCP server for the Bazacle todo API. Lets any MCP-compatible LLM client (Claude Code, Claude Desktop, Cursor, …) list, create, update, complete, and delete your todos.

Tools exposed:

| Tool | Description | | --- | --- | | list_todos | List todos. Filter by status, paginate with cursor. | | create_todo | Add a new todo. | | get_todo | Read one todo by id. | | update_todo | Edit a todo's content and/or status. | | complete_todo | Mark a todo as completed (shortcut). | | delete_todo | Permanently delete a todo. Requires user confirmation via MCP elicitation when the client supports it; otherwise relies on the client's destructive-tool prompt. |

Install

Get an API key from your dashboard at https://todo.bazacle.com/dashboard/keys (format: tdo_…), then pick your client below.

Claude Code

claude mcp add todo -s user \
  -e TODO_API_TOKEN=tdo_YOUR_KEY \
  -e TODO_API_BASE_URL=https://todo.bazacle.com \
  -- npx -y @bazacle/todo-mcp

Claude Desktop

Edit claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "todo": {
      "command": "npx",
      "args": ["-y", "@bazacle/todo-mcp"],
      "env": {
        "TODO_API_TOKEN": "tdo_YOUR_KEY",
        "TODO_API_BASE_URL": "https://todo.bazacle.com"
      }
    }
  }
}

If mcpServers already exists, merge — don't replace.

Cursor

Open Cursor → Settings → MCP → Add server, paste the same JSON shape as Claude Desktop.

Environment

| Variable | Required | Default | Notes | | --- | --- | --- | --- | | TODO_API_TOKEN | yes | — | Must start with tdo_. Manage via your dashboard. | | TODO_API_BASE_URL | no | baked at build time | Override to point at a self-hosted or staging instance. |

License

MIT.