Skip to main content
Glama

TickTick MCP V2

by chriswinsatlife
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

TickTick MCP V2

Enhanced TickTick MCP server with V2 API support for assignees, sections, comments, batch operations, and 35x performance improvement through checkpoint sync.

πŸš€ Features

V2 Enhanced Features

  • Task Assignment - Assign tasks to specific team members

  • Section Management - Organize tasks in kanban columns (New, In Progress, Future, Blocked)

  • Tag Management - Categorize and filter tasks with tags

  • Comments & Activity - Add timestamped comments and view task history

  • Batch Operations - Efficient bulk task operations

  • Checkpoint Sync - 35x performance improvement (1.1s vs 35s)

  • Advanced Filtering - Filter by assignee, section, tags, priority

Requirements

  • V2 session authentication is required

  • V1 OAuth is not yet implemented

πŸ”§ Setup

1. Configuration

cp .env_template .env # Edit .env with your TickTick session token

Get session token from browser DevTools:

  1. Open TickTick in browser, open DevTools (F12) β†’ Network tab

  2. Refresh page, find any api.ticktick.com request

  3. Copy full Cookie header β†’ TICKTICK_SESSION_TOKEN

2. Add to Cursor

Copy this JSON into your Cursor MCP config:

"ticktick_mcp_v2": { "command": "/Users/your_name/.local/bin/uv", "args": [ "run", "--directory", "/Users/your_name/ticktick_mcp_v2", "-m", "main" ] }

3. Switch to the server in Cursor

That's it. uv handles everything automatically.

πŸ› οΈ MCP Tools

Core Task Management

create_task

Create tasks with V2 enhancements:

create_task( title="Fix critical bug", project_id="cyhq", content="Details about the bug", assignee="carlos", # V2: assign to team member section="in_progress", # V2: set kanban section priority="high", tags="urgent, bug-fix", # V2: add tags due_date="2026-05-15T17:00:00.000+0000" )

update_task

Comprehensive task updates:

update_task( task_id="67c1d244d3bd919605c39402", project_id="cyhq", content="Status update on the task", # Append as comment assignee="ann", # V2: reassign section="blocked", # V2: move section status="complete" )

get_tasks

Advanced filtering:

get_tasks( project_id="cyhq", assignee="carlos", # V2: filter by assignee section="in_progress", # V2: filter by section tags="urgent", # V2: filter by tags priority="high", limit=50 )

Additional Tools

search_tasks

Search for tasks across projects using keywords:

search_tasks("Powerset meeting") search_tasks("schedule", "cyhq") search_tasks("Italian attorneys")

get_project_columns

Get column/section information for a project:

get_project_columns("cyhq")

V2 Advanced Features

The get_tasks and update_task tools provide all V2 functionality:

Filter by Assignee

get_tasks(assignee="carlos") get_tasks(assignee="me")

Filter by Section

get_tasks(section="in_progress") get_tasks(section="blocked")

Move Task to Section

update_task("task_id", section="blocked")

Assign Task to User

update_task("task_id", assignee="ann")

Add Comment to Task

update_task("task_id", add_comment="Working on this now")

Get Task Activity

get_task("task_id", include_activity=True)

Utility Features

Natural Date Parsing

Dates are automatically parsed in create_task and update_task:

create_task("Review docs", due_date="tomorrow at 2pm") update_task("task_id", due_date="next friday")

πŸ—‚οΈ Project & User Mappings

Project Aliases

  • cyhq, team, main, hq β†’ CYHQ project (600ce43b08d35100aa47658c)

  • inbox, personal, my_tasks β†’ Personal inbox

  • recurring, repeat β†’ CYHQ Recurring (66b32defaf7e9165b805afd7)

  • icebox, deferred β†’ CYHQ Icebox (66b785a2b83b1105e028c330)

User Aliases

  • carlos, cl β†’ Carlos (ID: 117021928)

  • ann, aj β†’ Ann (ID: 126258410)

  • chris, cy β†’ Chris/CY (ID: 115949154)

  • ai, ai_agent β†’ AI Agent (ID: 123145261)

Section Aliases

  • new, new_tasks, todo β†’ New Tasks (6481e516ff78514b6c688124)

  • in_progress, progress, active β†’ In Progress (67c8248bce389a2a32d12487)

  • future, backlog, later β†’ Future Tasks (65f67cb1725bd1c72a547083)

  • blocked, waiting, on_hold β†’ Blocked (67cbba658c34d109b8053419)

⚑ Performance Optimization

Checkpoint Sync

V2 includes intelligent caching with checkpoint sync:

  • 35x performance improvement (1.1s vs 35s for typical operations)

  • Delta sync only fetches changes since last checkpoint

  • Automatic fallback to full sync when needed

  • Cache stored automatically

Batch Operations

Efficient bulk operations:

  • Multiple task updates in single API call

  • Optimized for team workflows

  • Automatic cache invalidation

πŸ” Authentication

Currently supports V2 session authentication only:

  1. V2 Session Auth - Required for all features

  2. V1 OAuth - Configuration prepared but not yet implemented

πŸ—οΈ Architecture

ticktick_mcp/ β”œβ”€β”€ models/ # Pydantic data models β”œβ”€β”€ tools/ # MCP tool implementations β”œβ”€β”€ client_v2.py # V2 session client β”œβ”€β”€ config.py # Configuration and mappings β”œβ”€β”€ helpers.py # Utilities and decorators └── server.py # MCP server instance

πŸ› Troubleshooting

Common Issues

No V2 features available:

  • Check TICKTICK_SESSION_TOKEN in .env

  • Verify token is correct (get from browser DevTools)

  • Check MCP server logs for authentication errors

Tasks not updating:

  • Verify project IDs and task IDs

  • Check user has permission to modify tasks

  • Review assignee and section mappings

Performance issues:

  • Check authentication is working correctly

  • Monitor API rate limits

πŸ™ Acknowledgments

  • Based on jen6_ticktick_mcp foundation

  • Enhanced with V2 API research and optimization

  • Built for TaskFactory team workflow optimization

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

Enhanced TickTick task management server that provides rich functionality including task assignment, section management, comments, and batch operations with significantly improved performance through checkpoint sync.

  1. πŸš€ Features
    1. V2 Enhanced Features
    2. Requirements
  2. πŸ”§ Setup
    1. 1. Configuration
    2. 2. Add to Cursor
    3. 3. Switch to the server in Cursor
  3. πŸ› οΈ MCP Tools
    1. Core Task Management
    2. Additional Tools
    3. V2 Advanced Features
    4. Utility Features
  4. πŸ—‚οΈ Project & User Mappings
    1. Project Aliases
    2. User Aliases
    3. Section Aliases
  5. ⚑ Performance Optimization
    1. Checkpoint Sync
    2. Batch Operations
  6. πŸ” Authentication
    1. πŸ—οΈ Architecture
      1. πŸ› Troubleshooting
        1. Common Issues
      2. πŸ™ Acknowledgments

        Related MCP Servers

        • MCP Orchestrator Server

          mokafari
          A
          security
          -
          license
          A
          quality
          A server for task orchestration and coordination, facilitating task management with dependencies, multi-instance collaboration, and persistent task tracking.
          Last updated -
          7
          24
          MIT License

        • MCP TODO Checklist Server

          hevener10
          A
          security
          -
          license
          A
          quality
          A server that implements a checklist management system with features like task creation, progress tracking, data persistence, and item comments.
          Last updated -
          5
          3

        • DeltaTask MCP Server

          brysontang
          A
          security
          -
          license
          A
          quality
          Provides API access to a locally-hosted task management system with features for creating, updating, and organizing tasks, including support for urgency levels, effort estimates, subtasks, and bi-directional sync with Obsidian markdown files.
          Last updated -
          12
          9
          MIT License
          • Apple

        • TickTick MCP Server

          jen6
          -
          security
          -
          license
          -
          quality
          An MCP server that enhances TickTick workflow by providing comprehensive task management tools with improved filtering capabilities, allowing AI assistants and MCP-compatible applications to interact with TickTick tasks with greater precision.
          Last updated -
          33

        View all related MCP servers

        New MCP Servers

        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/chriswinsatlife/ticktick_mcp_v2'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server