TickTick helps users organize daily work by creating and updating tasks, managing to-do lists, setting due dates and reminders, organizing tasks with tags, and tracking progress across projects and routines.
Hermes is Nous Research's command-line agent. MCP servers are declared in its YAML config and reloaded without a restart.
This guide connects TickTick MCP to Hermes through MewCP, so Hermes can use TickTick MCP's 57 tools, like list_projects, get_project_by_id and get_project_with_undone_tasks, without your TickTick MCP credentials ever reaching the app.
TickTick MCP signs in through managed OAuth. MewCP stores the token encrypted, refreshes it before it expires and injects it only at call time. Your agent never holds it, so it can never leak it.
More apps
Work with pages, databases, blocks and collaborative knowledge stored in Notion. Create, update and organize content while building workflows around structured information and documentation.
Create, track, and manage Google Tasks and task lists directly from your AI workflows. This stateless, multi-tenant MCP server exposes the Google Tasks API for listing, creating, updating, completing, and deleting both tasks and task lists. Mutating tools such as update_task and update_tasklist return both the before and after state of the resource, making it easy to build assistants and automations that manage to-do lists and reminders on a users behalf
Connect AI agents to Miro to create, read, update, and organize collaborative boards, diagrams, sticky notes, shapes, and other visual workspace content.
Connect AI agents to ClickUp to manage tasks, projects, documents, lists, comments, and workflows, while searching workspace data and automating project management activities.
Other clients
TickTick MCP works the same way in every client below. Pick yours for its own guide.
Free to start.
Scope access to the exact TickTick MCP tools and accounts you allow, work and personal side by side. Anything outside that scope is refused at call time, even when the model asks for it.
Each call is logged: what ran, on which account, and whether it worked. Failures come back structured, so the agent knows whether to retry instead of guessing.
Every app sits behind one secure MCP URL, and there is no server for you to deploy or keep running. Add an integration in the dashboard and it is live on the next call, with no config to change and no new credentials to wire up. Tools load only when a task needs them, so your agent stays fast and focused however many apps you connect.
Edit config.yaml in your Hermes config directory (~/.hermes).
Put this under the top-level "mcp_servers:" key.
Run /reload-mcp in Hermes, or start a fresh session. Sign in when the browser window opens.
Start a new chat and ask: "List the tools you can use from MewCP." You should see your connected apps.
List projects. Supports offset/limit pagination; unpaginated results also include virtual "inbox".
Get project details by projectId.
Get project details and all undone tasks in the project by projectId.
List members of a shared project. Use a returned username when assigning a task in that project.
Create a new project (list) in TickTick.
Update an existing project by projectId.
Create a new task in TickTick.
Update a task. Set parentId='' to detach; set startDate/dueDate to "1970-01-01T00:00:00.000+0000" to clear. completedTime can only correct a closed task's completion timestamp and cannot be cleared.
Assign a task in a shared project to one of the project's members.
Remove the assignee from a task in a shared project.
Get a task by projectId and taskId.
Mark a task as completed by projectId and taskId.
Complete one checklist item in a CHECKLIST task.
Delete a task by projectId and taskId.
Complete multiple tasks in a project. Maximum 20 tasks per request.
List all habits of the current user.
List all habit sections of the current user.
Get habit details by habitId.
Create a new habit in TickTick.
Update an existing habit by habitId.
Create or update check-ins for a habit by habitId.
Get habit check-ins by habitIds and yyyyMMdd int stamp range.
Get a single focus record by focusId and type.
Get focus records by time range and type. The time range must not exceed one month.
Delete a focus record by focusId and type.
Create a focus record. Required: startTime, endTime, type (0=pomodoro, max 3h; 1=timing, max 12h). Optional: taskId, habitId, note.
Update an existing focus record. The focus type is required.
Search tasks by keyword. Returns a list of matching tasks with taskId, title, and url.
Search tasks in TickTick. Return a list of relevant result with IDS, title and URLs.
Fetch the full contents of a task by its ID.
List undone tasks within a date range. The maximum range is 14 days between startDate and endDate.
List undone tasks by time query: today, last24hour, last7day, tomorrow, next24hour, next7day.
Get full task details by taskId.
Filter tasks by various criteria including date range, project IDs, priority, tag, kind and status.
Get completed tasks based on specified search criteria including project IDs and date range.
Move tasks to different projects. Used for reorganizing tasks across projects.
Batch add multiple tasks to TickTick. Each task should have required fields filled in.
Batch update existing tasks.
Get user preferences including timezone settings.
List all columns in a project by projectId.
Create a new column in a project.
Update an existing column in a project by columnId.
Get comments for a task by projectId and taskId.
Add a comment to a task. Comment content is plain text, max 1024 characters.
Delete a comment from a task by comment id.
List all countdowns of the current user.
List all project groups of the current user.
Create a new project group.
Update an existing project group by projectGroupId.
Delete a project group by projectGroupId.
List all tags of the current user.
Create a new tag.
Update tag attributes other than its name or label.
Rename a tag and its display label.
Delete a tag and remove its task associations.
List third-party calendar accounts connected to TickTick.
Query events from connected third-party calendars. Omit the query for the server's default range (now through the next three months); explicit ranges cannot exceed three months.
