batch_update_tasks
Batch create, update, and/or delete multiple tasks in a single request
LABSCO SUMMARY
A task dictated mid-conversation lands complete, instead of as a title you have to go back and fix.
create_task accepts dueDate, startDate, priority, reminders, repeatFlag and checklist items in the same call as the title, so nothing is deferred to a clean-up pass. batch_update_tasks does adds, updates and deletes in one request, which is what makes a weekly review workable rather than tedious, and get_inbox_tasks resolves the inbox project ID from the profile — the one project you cannot look up by name is still reachable.
What it is
A TickTick client in 16 tools covering the two objects that matter — projects and tasks — plus subtasks, the inbox, and completed history.
What you get
- The project list, a single project by ID, or a project returned together with its tasks and columns
- Projects created, updated and deleted, including colour, kind, view mode and sort order
- Tasks created and updated with the whole shape in one call: content, description, start and due dates, all-day flag, priority, reminders, a repeat flag and checklist items
- A task completed, deleted, or read back by project and task ID
- Adds, updates and deletes for many tasks in a single request
- The inbox without hunting for its project ID — it is resolved from the user profile — and completed tasks across all projects within a date range
- The subtasks under a parent task, and the authenticated user's profile
Requirements
A TickTick account and an OAuth application registered against it, addressed through TICKTICK_CLIENT_ID, TICKTICK_CLIENT_SECRET and TICKTICK_ACCESS_TOKEN.
Setup effort
One command plus credentials — npx -y @alexarevalo.ai/mcp-server-ticktick, then supply credentials
USE CASES
01
Capturing a task mid-conversation
One call takes the title, the description, a start and due date, a priority, reminders, a repeat flag and the checklist items, so the task lands finished rather than as something to tidy up later.
02
Running a weekly review
Pull a project together with its tasks and columns, look at what actually got completed in the date range, then reschedule, close and drop what is left in one batched request.
03
Clearing the inbox
Read the inbox without needing to know its project ID — it is resolved from the profile — then close what is done and move the rest into a real project.
04
Setting up a project board for a new piece of work
Create the project with the view mode and colour you want, seed it with its first tasks, and adjust the project afterwards without touching the tasks under it.
16 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
complete_task
Complete a task
create_project
Create a new project
create_task
Create a new task
delete_project
Delete a project
delete_task
Delete a task
get_completed_tasks
Get completed tasks across all projects within a date range
get_current_user
Get the current authenticated user profile
get_inbox_tasks
Get tasks from the inbox (resolves inbox project ID automatically from user profile)
get_project_by_id
Get a project by ID
get_project_with_data
Get a project with its tasks and columns
get_subtasks
Get all subtasks of a parent task by fetching project data and filtering by parentId
get_task_by_ids
Get a task by ProjectId and TaskId
get_user_projects
Get all user projects
update_project
Update an existing project
update_task
Update an existing task
BEFORE YOU INSTALL
What to know first
Tools you get
16 tools when we connected.
Requires
- npx on PATH
- TICKTICK_CLIENT_ID in your environment
- TICKTICK_CLIENT_SECRET in your environment
- TICKTICK_ACCESS_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 16 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y @alexarevalo.ai/mcp-server-ticktickMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"ticktick": {
"command": "npx",
"args": [
"-y",
"@alexarevalo.ai/mcp-server-ticktick"
],
"env": {
"TICKTICK_CLIENT_ID": "<YOUR_CLIENT_ID>",
"TICKTICK_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>",
"TICKTICK_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>"
}
}
}
}
