Donetick MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Donetick MCP Server list my chores for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Donetick MCP
An MCP server that turns your Donetick instance into tools. Create, list, update, complete, and skip chores, manage things, and check circle members and completion history.
Authenticated with a Donetick API token (no username or password). Built with FastMCP.
Run with Docker
You need a Donetick instance and an access token (settings > Advanced > API).
docker build -t donetick-mcp .
docker run -e DONETICK_BASE_URL=https://donetick.example.com \
-e DONETICK_API_TOKEN=your-token \
donetick-mcpRelated MCP server: Donetick MCP Server
Settings
name | default | notes |
| - | required, https only |
| - | required, from Donetick settings |
| INFO | |
| 10 | |
| 10 |
Values can come from a .env file in the working directory.
Serve over HTTP
By default the server talks stdio (one process per client). To expose it as an HTTP MCP endpoint behind a gateway (e.g. LiteLLM), set the FastMCP transport env vars - no code change required:
env | default |
|
|
|
|
|
|
|
|
Example - serve streamable-http on all interfaces:
FASTMCP_TRANSPORT=streamable-http FASTMCP_HOST=0.0.0.0 FASTMCP_PORT=8000 \
donetick-mcpTools
Chores: list_chores, get_chore, create_chore, complete_chore, update_chore, delete_chore, update_chore_priority, update_chore_assignee, skip_chore, update_subtask_completion, archive_chore, unarchive_chore, undo_chore, approve_chore, reject_chore, start_chore, pause_chore
Things: list_things, get_thing, get_thing_state, change_thing_state, create_thing, update_thing, delete_thing, get_thing_history
Circle: get_circle_members, list_circles, get_join_requests, accept_join_request, join_circle, leave_circle, change_member_role, delete_circle_member, redeem_points
Projects: list_projects, create_project, update_project, delete_project
History: get_chore_history, get_all_chores_history, get_chore_details
License
MIT
Available Tools
41 toolsaccept_join_requestAccept Join RequestC
Accept a pending circle join request.
Inputs: request_id (required). Returns: result
approve_choreApprove ChoreB
Approve a pending chore completion (requires approval).
Inputs: chore_id (required). Returns: result
archive_choreArchive ChoreB
Archive a chore (moves it out of the active list).
Inputs: chore_id (required). Returns: result
change_member_roleChange Member RoleB
Change a circle member's role (admin, member, or manager).
Inputs: role (required), member_id (required). Returns: result
change_thing_stateChange Thing StateA
Change a thing's state.
Provide set_value to set it directly, or op as a signed integer to add to a numeric state.
Inputs: thing_id (required), op, set_value. Returns: result
complete_choreComplete ChoreB
Mark a chore as complete.
Inputs: chore_id (required), completed_by. Returns: result
create_choreCreate ChoreB
Create a new chore in Donetick.
Inputs: name (required), due_date, usernames, created_by, +1 more. Returns: result
create_projectCreate ProjectB
Create a new project.
Inputs: name (required), icon, color, description. Returns: result
create_thingCreate ThingA
Create a new thing (trackable value).
Inputs: name (required), type (required), state. Returns: result
delete_choreDelete ChoreA
Delete a chore permanently.
Only the chore creator can delete a chore.
Inputs: chore_id (required). Returns: result
delete_circle_memberDelete Circle MemberB
Remove a member from the circle.
Inputs: member_id (required). Returns: result
delete_projectDelete ProjectB
Delete a project permanently.
Inputs: project_id (required). Returns: result
delete_thingDelete ThingA
Delete a thing permanently.
Inputs: thing_id (required). Returns: result
get_all_chores_historyGet All Chores HistoryA
Get completion history for all chores with pagination.
Inputs: limit, offset. Returns: result
get_choreGet ChoreB
Get details of a specific chore by its ID.
Inputs: chore_id (required). Returns: result
get_chore_detailsGet Chore DetailsA
Get detailed chore information including completion statistics.
Inputs: chore_id (required). Returns: result
get_chore_historyGet Chore HistoryB
Get completion history for a specific chore.
Inputs: chore_id (required). Returns: result
get_circle_membersGet Circle MembersA
Get all members in the circle (household/team).
Inputs: no named parameters. Returns: result
get_join_requestsGet Join RequestsA
List pending join requests for the circle.
Inputs: no named parameters. Returns: result
get_thingGet ThingB
Get a thing by its ID.
Inputs: thing_id (required). Returns: result
get_thing_historyGet Thing HistoryB
Get a thing's state-change history.
Inputs: thing_id (required). Returns: result
get_thing_stateGet Thing StateC
Get the current state of a thing.
Inputs: thing_id (required). Returns: result
join_circleJoin CircleA
Join a circle with an invite code.
Inputs: invite_code (required). Returns: result
leave_circleLeave CircleB
Leave the current circle.
Inputs: no named parameters. Returns: result
list_choresList ChoresB
List all chores from Donetick.
Inputs: detail_level, filter_active, assigned_to_user_id. Returns: result
list_circlesList CirclesA
List circles the user belongs to.
Inputs: no named parameters. Returns: result
list_projectsList ProjectsA
List all projects.
Inputs: no named parameters. Returns: result
list_thingsList ThingsA
List all things (trackable values).
Inputs: no named parameters. Returns: result
pause_chorePause ChoreA
Pause a running chore timer.
Inputs: chore_id (required). Returns: result
redeem_pointsRedeem PointsC
Redeem reward points for a member.
Inputs: points (required), member_id (required). Returns: result
reject_choreReject ChoreA
Reject a pending chore completion (requires approval).
Inputs: chore_id (required). Returns: result
skip_choreSkip ChoreA
Skip a chore without marking it complete.
Inputs: chore_id (required). Returns: result
start_choreStart ChoreB
Start a chore timer (mark as in progress).
Inputs: chore_id (required). Returns: result
unarchive_choreUnarchive ChoreA
Unarchive a chore (back to active).
Inputs: chore_id (required). Returns: result
undo_choreUndo ChoreB
Undo the last completion of a chore.
Inputs: chore_id (required). Returns: result
update_choreUpdate ChoreA
Update an existing chore with new values.
Only provide fields you want to change - other fields remain unchanged.
Inputs: chore_id (required), name, points, isActive, +14 more. Returns: result
update_chore_assigneeUpdate Chore AssigneeA
Reassign a chore to a different circle member.
Inputs: user_id (required), chore_id (required). Returns: result
update_chore_priorityUpdate Chore PriorityA
Update a chore's priority level (0-4).
Inputs: chore_id (required), priority (required). Returns: result
update_projectUpdate ProjectA
Update a project's name, description, color, or icon.
Inputs: name (required), project_id (required), icon, color, +1 more. Returns: result
update_subtask_completionUpdate Subtask CompletionB
Mark a subtask as complete or incomplete within a chore.
Inputs: chore_id (required), completed (required), subtask_id (required). Returns: result
update_thingUpdate ThingB
Update a thing's name, type, and optional state.
Inputs: name (required), type (required), thing_id (required), state. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 41 tools
Most tools have distinct purposes, but a few overlap: get_chore and get_chore_details both retrieve a single chore (the latter with stats), and get_chore_history vs get_all_chores_history could be confused. However, descriptions generally clarify scope, so agents can usually pick correctly.
The majority follow a consistent verb_noun snake_case pattern (e.g., list_chores, create_chore, update_chore, delete_chore). Minor deviations include change_thing_state and redeem_points, but they are readable and do not break the overall pattern.
With 41 tools, the server far exceeds the typical well-scoped range. While the domain spans chores, circles, things, projects, and history, the sheer number makes the surface heavy and harder to navigate, and many tools could potentially be consolidated.
The tool set covers CRUD for chores, things, and projects, plus circle management, history, timers, approval flows, and rewards. A few potential gaps exist (e.g., no create_circle or delete_circle), but the core workflows appear well-supported without obvious dead ends.
Maintenance
Related MCP Connectors
Lets Claude, ChatGPT, and Muse read and update your beckett tasks, notes, calendar, and lists.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Connect your Cormak.app account to manage projects, task boards, AI agents and creative work from your AI assistant. The server exposes up to 83 tools, limited to the OAuth permissions you choose. Organize tasks, read and update project drafts, inspect saved studio results, create product descriptions and images, and request supported photo, video, 3D, voiceover, SEO and advertising operations. Publishing saved projects requires separate owner approval. Reading and ordinary manual task management do not themselves start paid generation. AI operations use credits from your connected Cormak account and require owner confirmation, or an existing bounded spending permission for supported product operations. You can limit and revoke connections in Cormak. The MCP does not provide bank access, payment details or provider API keys. CRM, streaming website generation and business-plan generation are not exposed through this integration. Get started: https://app.cormak.app/mcp Setup guide and examples: https://cormak.app/blog/cormak-mcp-guide Privacy: https://cormak.app/privacy Support: https://cormak.app/contact
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for Donetick chores management. Provides 27 tools to control Donetick instance via Claude or other MCP clients.2728 PyPI2MIT
- AlicenseAqualityDmaintenanceMCP server for Donetick chores management, enabling AI assistants to list, create, complete, update, and delete chores with full API integration and rate limiting.2080 PyPI12MIT
- FlicenseNot gradedqualityFmaintenanceEnables Claude Desktop and other MCP clients to manage Todoist tasks, projects, and labels through natural language.3-
- FlicenseNot gradedqualityDmaintenanceEnables Claude to interact with Trello boards, lists, cards, and labels through a set of MCP tools.-