Donetick MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Logging level (DEBUG, INFO, WARNING, ERROR) | INFO |
| RATE_LIMIT_BURST | No | Maximum burst size | 10 |
| DONETICK_BASE_URL | Yes | Your Donetick instance URL (must use HTTPS) | |
| DONETICK_PASSWORD | Yes | Your Donetick password | |
| DONETICK_USERNAME | Yes | Your Donetick username | |
| RATE_LIMIT_PER_SECOND | No | Requests per second limit | 10.0 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_choresA | List all chores from Donetick. Optionally filter by active status or assigned user. Returns comprehensive chore details including name, description, due dates, assignees, and status. Use detail_level to control response size: 'brief' for essential fields only, 'full' for complete details (default). |
| get_choreC | Get details of a specific chore by its ID. Returns complete chore information including all metadata, assignees, labels, and scheduling details. |
| create_choreA | Create a new chore in Donetick with easy natural language inputs. Use simple parameters like usernames, days_of_week, and time_of_day - they're automatically transformed to the correct API format. EXAMPLES:
Returns the created chore with its assigned ID and all metadata. |
| complete_choreA | Mark a chore as complete. Optionally specify which user completed the chore. Returns the updated chore with completion timestamp. |
| update_choreA | Update an existing chore with new values. Can modify any chore property including name, description, schedule, assignees, priority, points, labels, privacy settings, and more. Only provide fields you want to change - other fields remain unchanged. |
| delete_choreA | Delete a chore permanently. Note: Only the chore creator can delete a chore. Returns confirmation of deletion. |
| update_chore_priorityA | Update a chore's priority level (0-4). Use this to adjust how urgent a chore is without editing other details. 0=unset, 1=lowest, 2=low, 3=medium, 4=highest. Returns the updated chore. |
| update_chore_assigneeA | Reassign a chore to a different circle member. Use this to dynamically change who is responsible for a chore. Get member IDs from list_circle_members or get_circle_members. Returns the updated chore. |
| skip_choreA | Skip a chore without marking it complete. For recurring chores, this schedules the next occurrence without completing the current one. Useful for chores that aren't needed this cycle. One-time chores will be marked as inactive. Returns the updated chore with the new due date. |
| update_subtask_completionA | Mark a subtask as complete or incomplete within a chore. This allows tracking progress on chores with multiple steps without completing the entire chore. Useful for checklists and multi-step tasks. Returns the updated chore with subtask progress. |
| list_labelsA | List all labels in the circle. Returns all available labels with their IDs, names, and colors. Use these labels to organize and categorize chores. |
| create_labelA | Create a new label for organizing chores. Labels help categorize and filter chores by type, location, or any custom criteria. Optionally specify a color in hex format (e.g., '#FF5733'). |
| update_labelA | Update an existing label's name and/or color. Use this to rename labels or change their colors for better organization. |
| delete_labelA | Delete a label permanently. This will remove the label from all chores that use it. Use with caution as this action cannot be undone. |
| get_circle_membersA | Get all members in the circle (household/team). Returns user information including user IDs, usernames, display names, roles (admin/member), active status, and points. Use this to see who you can assign chores to. |
| list_circle_usersA | List all users in the circle with basic information. Returns user IDs, usernames, display names, email addresses, roles, points earned, and active status. Similar to get_circle_members but may include additional user details. |
| get_user_profileA | Get the current user's detailed profile information. Returns comprehensive user data including notification preferences, webhook configuration, storage usage, points, and account metadata. Use this to view or manage personal settings and statistics. |
| get_chore_historyA | Get completion history for a specific chore. Returns all completion records including when the chore was completed, by whom, completion notes, and points awarded. Useful for tracking chore completion patterns and accountability. |
| get_all_chores_historyA | Get completion history for all chores with pagination support. Returns completion records across all chores in the circle, showing who completed what and when. Use limit and offset for pagination through large result sets. |
| get_chore_detailsA | Get detailed chore information including completion statistics and analytics. Returns extended details not available in standard get_chore: total completion count, last completion date and user, average duration, and recent completion history. Useful for performance analysis and chore optimization. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/jason1365/donetick-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server