Skip to main content
Glama
Donetick MCP Server

Donetick MCP Server

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-mcp

Related MCP server: Donetick MCP Server

Settings

name

default

notes

DONETICK_BASE_URL

-

required, https only

DONETICK_API_TOKEN

-

required, from Donetick settings

LOG_LEVEL

INFO

RATE_LIMIT_PER_SECOND

10

RATE_LIMIT_BURST

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

FASTMCP_TRANSPORT

stdio

FASTMCP_HOST

127.0.0.1

FASTMCP_PORT

8000

FASTMCP_STREAMABLE_HTTP_PATH

/mcp

Example - serve streamable-http on all interfaces:

FASTMCP_TRANSPORT=streamable-http FASTMCP_HOST=0.0.0.0 FASTMCP_PORT=8000 \
  donetick-mcp

Tools

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 tools
accept_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

    B3.3/5.0

    Scored across 41 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers