Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ticktick_configure_oauth | Configure OAuth2 credentials for TickTick API v1.
This is the first step for OAuth authentication. After configuration,
you'll receive an authorization URL to visit.
Args:
params: OAuth credentials
Returns:
Authorization URL and instructions
|
| ticktick_authorize_oauth | Complete OAuth2 authorization with the code from callback URL.
Use this after visiting the authorization URL and being redirected.
Args:
params: Authorization code
Returns:
Success message with token details
|
| ticktick_login | Login with username/password for v2 API access.
This enables extended features like tags, habits, and focus timer.
Args:
params: Login credentials
Returns:
Success message
|
| ticktick_auth_status | Check current authentication status.
Returns:
Authentication status details
|
| ticktick_logout | Clear all authentication tokens (logout).
Returns:
Confirmation message
|
| ticktick_list_tasks | List tasks with optional filtering. Supports filtering by project, priority, tags, and search query. |
| ticktick_get_task | Get a specific task by ID. Requires both task ID and project ID. |
| ticktick_create_task | Create a new task in TickTick.
Can set title, description, due date, priority, tags, and more.
If project_id is not provided, task goes to inbox.
|
| ticktick_update_task | Update an existing task. Only provided fields will be updated. |
| ticktick_complete_task | Mark a task as complete. |
| ticktick_uncomplete_task | Reopen a completed task (mark as incomplete). |
| ticktick_delete_task | Delete a task permanently.
Warning: This action cannot be undone.
|
| ticktick_move_task | Move a task to a different project/list. |
| ticktick_create_subtask | Create a subtask under a parent task.
Note: Requires v2 API for full hierarchy support.
|
| ticktick_get_completed_tasks | Get completed tasks within a date range. Requires v2 API authentication (username/password login). |
| ticktick_batch_create_tasks | Create multiple tasks in a single request. More efficient than creating tasks one by one. |
| ticktick_batch_delete_tasks | Delete multiple tasks in a single request.
Warning: This action cannot be undone.
|
| ticktick_list_projects | List all projects/lists. Returns project details including ID, name, color, and task count. |
| ticktick_get_project | Get details of a specific project including its tasks. |
| ticktick_create_project | Create a new project/list. Projects can be organized in folders and have different view modes. |
| ticktick_update_project | Update an existing project's properties. |
| ticktick_delete_project | Delete a project and all its tasks.
Warning: This action cannot be undone. All tasks in the project will be deleted.
|
| ticktick_archive_project | Archive a project. Archived projects are hidden from the main view but can be restored. Requires v2 API authentication. |
| ticktick_list_folders | List all project folders. Folders are used to organize projects. |
| ticktick_create_folder | Create a new project folder. Folders help organize projects into logical groups. |
| ticktick_update_folder | Rename a project folder. |
| ticktick_delete_folder | Delete a project folder. Projects in the folder will be moved to the root level. |
| ticktick_list_tags | List all tags in your TickTick account. Requires v2 API authentication (username/password login). Tags can be nested (have parent-child relationships). |
| ticktick_create_tag | Create a new tag. Tags can be nested by specifying a parent tag name. Requires v2 API authentication. |
| ticktick_update_tag | Update a tag's properties (color, etc.). Requires v2 API authentication. |
| ticktick_rename_tag | Rename a tag. All tasks with the old tag will be updated to use the new name. Requires v2 API authentication. |
| ticktick_merge_tags | Merge one tag into another. The source tag will be deleted, and all tasks will be moved to the target tag. Requires v2 API authentication. |
| ticktick_delete_tag | Delete a tag. The tag will be removed from all tasks. Requires v2 API authentication. |
| ticktick_get_tag_tasks | Get all tasks that have a specific tag. Requires v2 API authentication. |
| ticktick_list_habits | List all habits. Requires v2 API authentication (username/password login). |
| ticktick_get_habit | Get details of a specific habit including its statistics. Requires v2 API authentication. |
| ticktick_create_habit | Create a new habit to track. Set daily goals, reminders, and custom icons/colors. Requires v2 API authentication. |
| ticktick_update_habit | Update an existing habit's properties. Requires v2 API authentication. |
| ticktick_delete_habit | Delete a habit.
Warning: This will delete all check-in history for this habit.
Requires v2 API authentication.
|
| ticktick_checkin_habit | Record a habit check-in. Track your daily progress toward habit goals. Requires v2 API authentication. |
| ticktick_get_habit_stats | Get statistics for a specific habit. Includes completion rate, streaks, and historical data. Requires v2 API authentication. |
| ticktick_get_today_habits | Get today's status for all habits. Shows which habits are completed and which need attention. Requires v2 API authentication. |
| ticktick_start_pomodoro | Start a Pomodoro focus session. The classic Pomodoro technique with customizable duration. Can be linked to a specific task. Requires v2 API authentication. |
| ticktick_start_stopwatch | Start a stopwatch focus session. Open-ended focus tracking without a fixed duration. Requires v2 API authentication. |
| ticktick_stop_focus | Stop the current focus session. Optionally save or discard the focus record. Requires v2 API authentication. |
| ticktick_get_focus_records | Get focus session history. Filter by date range and focus type (pomodoro/stopwatch). Requires v2 API authentication. |
| ticktick_get_today_focus | Get today's focus time statistics. Shows total focus time, pomodoro count, and progress toward daily goal. Requires v2 API authentication. |
| ticktick_get_focus_settings | Get current Pomodoro/focus settings. Shows work duration, break times, and daily goals. Requires v2 API authentication. |
| ticktick_update_focus_settings | Update Pomodoro/focus settings. Customize work duration, breaks, and automation preferences. Requires v2 API authentication. |
| ticktick_delete_focus_record | Delete a focus record.
Warning: This cannot be undone.
Requires v2 API authentication.
|
| ticktick_get_overview | Get today's productivity overview. Includes task status, habit progress, and focus statistics. Extended features require v2 API authentication. |
| ticktick_get_daily_summary | Get detailed summary for a specific day. Shows tasks completed, habits done, and focus time. Requires v2 API for complete data. |
| ticktick_get_weekly_report | Get weekly productivity report. Includes daily breakdown, totals, and trends. Requires v2 API for complete data. |
| ticktick_get_productivity_score | Calculate your productivity score. Score is based on task completion, habit consistency, and focus time. Includes personalized recommendations. Extended metrics require v2 API authentication. |
| ticktick_get_task_analytics | Get detailed task analytics. Shows priority distribution, due date analysis, and tag usage. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |