Donetick MCP Server

April 3, 2026 · View on GitHub

An MCP server for Donetick chores management. Gives Claude and other MCP-compatible AI assistants full control over your Donetick instance — 27 tools covering chores, subtasks, labels, timers, and more.

Quick Start

uvx donetick-mcp

Claude Desktop / Claude Code

Add to your MCP config (.mcp.json, claude_desktop_config.json, etc.):

{
  "mcpServers": {
    "donetick": {
      "command": "uvx",
      "args": ["donetick-mcp"],
      "env": {
        "DONETICK_BASE_URL": "https://your-instance.com",
        "DONETICK_USERNAME": "your_username",
        "DONETICK_PASSWORD": "your_password"
      }
    }
  }
}

Note: DONETICK_BASE_URL can be HTTP for local/private network instances.

Tools (27)

Chore Management

Tool	Description
`list_chores`	List chores with optional filters (active, assigned user, brief/full detail)
`get_chore`	Get full chore details including subtasks and labels
`create_chore`	Create a chore — supports usernames, day names, reminders, subtasks. Defaults to assigning to anyone in the circle (round-robin)
`update_chore`	Update any fields: name, description, schedule, assignees (by username), labels (add/remove/set by name), priority, notifications
`delete_chore`	Delete a chore (creator only)
`list_archived_chores`	List archived/hidden chores

Chore Actions

Tool	Description
`complete_chore`	Mark a chore as done
`skip_chore`	Skip without completing — schedules next occurrence for recurring chores
`archive_chore`	Soft-delete / hide a chore
`unarchive_chore`	Restore an archived chore
`approve_chore`	Approve a completion that requires approval
`reject_chore`	Reject a completion that requires approval
`update_due_date`	Quick reschedule without a full update

Timer

Tool	Description
`start_chore_timer`	Start time tracking
`pause_chore_timer`	Pause time tracking

Subtasks

Tool	Description
`create_subtask`	Add a checklist item to a chore
`delete_subtask`	Remove a subtask
`update_subtask_completion`	Mark a subtask complete/incomplete
`convert_chore_to_subtask`	Convert a standalone chore into a subtask of another (deletes the original)

Labels

Tool	Description
`list_labels`	List all labels in the circle
`create_label`	Create a new label (name + optional hex color)
`update_label`	Rename or recolor a label
`delete_label`	Delete a label (removes from all chores)

Labels can also be managed directly on chores via update_chore using add_label_names, remove_label_names, or set_label_names.

Users & History

Tool	Description
`list_circle_members`	List all members with IDs, roles, and points
`get_user_profile`	Current user's profile, points, and settings
`get_chore_history`	Completion history — for one chore or all (with pagination)
`get_chore_details`	Chore stats: total completions, average duration, recent history

Configuration

Variable	Required	Default	Description
`DONETICK_BASE_URL`	Yes	—	Donetick instance URL
`DONETICK_USERNAME`	Yes	—	Donetick username
`DONETICK_PASSWORD`	Yes	—	Donetick password
`LOG_LEVEL`	No	`INFO`	`DEBUG`, `INFO`, `WARNING`, `ERROR`
`RATE_LIMIT_PER_SECOND`	No	`10.0`	API rate limit
`RATE_LIMIT_BURST`	No	`10`	Burst capacity

Create Chore Examples

Simple one-time chore:

{"name": "Fix leaky faucet", "due_date": "2025-11-10", "priority": 3}

Recurring chore on specific days:

{"name": "Take out trash", "days_of_week": ["Mon", "Thu"], "time_of_day": "19:00", "usernames": ["Alice"]}

With subtasks and reminders:

{"name": "Weekly review", "frequency_type": "weekly", "subtask_names": ["Check email", "Update notes"], "remind_minutes_before": 15}

If no usernames provided, the chore is assigned to everyone in the circle with round-robin rotation.

Alternative Installation

Docker

git clone https://github.com/danielrosehill/donetick-mcp.git
cd donetick-mcp
cp .env.example .env  # edit with your credentials
docker-compose up -d

pip

pip install donetick-mcp
donetick-mcp  # requires env vars set

Development

git clone https://github.com/danielrosehill/donetick-mcp.git
cd donetick-mcp
python3 -m venv venv && source venv/bin/activate
pip install -e ".[dev]"
pytest  # 200 tests, requires DONETICK_* env vars

License

MIT