dotodo-mcp

MCP (Model Context Protocol) server for dotodo - manage your todos from AI assistants like Claude.

Setup

1. Get an API Key

Sign in to dotodo and go to Settings > API Keys to generate a key.

2. Configure Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "dotodo": {
      "command": "npx",
      "args": ["dotodo-mcp"],
      "env": {
        "DOTODO_API_URL": "https://api.dotodo.co",
        "DOTODO_API_KEY": "sk_dotodo_your_key_here"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add dotodo -- npx dotodo-mcp \
  --env DOTODO_API_URL=https://api.dotodo.co \
  --env DOTODO_API_KEY=sk_dotodo_your_key_here

3. Restart Claude

Restart Claude Desktop to apply the changes.

Available Tools

| Tool | Description | |------|-------------| | add_todo | Create a new todo with optional deadline, priority, project, and tags | | list_todos | List and filter todos by status, date, priority, project, and more | | complete_todo | Toggle todo completion status | | update_todo | Update todo title, description, status, priority, or deadline | | delete_todo | Soft-delete a todo | | get_project_todos | Get all todos for a specific project | | list_projects | List all projects | | create_project | Create a new project | | add_tag | Create a new tag | | list_tags | List all available tags | | add_todos | Create multiple todos at once (max 50) | | complete_todos | Toggle completion for multiple todos (max 100) | | delete_todos | Delete multiple todos at once (max 100) |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | DOTODO_API_URL | Yes | API server URL (e.g., https://api.dotodo.co) | | DOTODO_API_KEY | Yes | Your API key (sk_dotodo_...) |

License

MIT