Labsco
alexarevalo9 logo

TickTick

★ 71

from alexarevalo9

Manage tasks, projects, and habits using the TickTick API.

🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys
#automation#calendar#devops#git#security

TickTick MCP Server

smithery badge

MCP Server for the TickTick API, enabling task management, project organization, habit tracking, and more.

Features

  • ✅ Task Management: Create, read, update, and delete tasks with all available properties
  • 📊 Project Management: Create, read, update, and delete projects with customizable views
  • 📋 Subtask Support: Full support for managing subtasks within parent tasks
  • 🔄 Complete Task Control: Set priorities, due dates, reminders, and recurring rules
  • 🔐 OAuth Authentication: Full OAuth2 implementation for secure API access
  • ⚠️ Comprehensive Error Handling: Clear error messages for common issues

Tools

  1. get_task_by_ids

    • Get a specific task by project ID and task ID
    • Inputs:
      • projectId (string): Project identifier
      • taskId (string): Task identifier
    • Returns: Task object matching TickTickTaskSchema

  2. create_task

    • Create a new task in a project
    • Inputs:
      • title (string): Task title
      • projectId (string): Project id
      • content (optional string): Task content
      • desc (optional string): Task description
      • isAllDay (optional boolean): Is all day task
      • startDate (optional string): Task start date in "yyyy-MM-dd'T'HH:mm:ssZ" format
      • dueDate (optional string): Task due date in "yyyy-MM-dd'T'HH:mm:ssZ" format
      • timeZone (optional string): Task time zone (e.g., "America/Los_Angeles")
      • reminders (optional string[]): List of reminder triggers in iCalendar format
      • repeatFlag (optional string): Task repeat flag in iCalendar format
      • priority (optional number): Task priority (None: 0, Low: 1, Medium: 3, High: 5)
      • sortOrder (optional string): Task sort order
      • items (optional array): List of subtasks with:
        • title (string): Subtask item title
        • startDate (optional string): Subtask date in "yyyy-MM-dd'T'HH:mm:ssZ" format
        • isAllDay (optional boolean): Is all day subtask item
        • sortOrder (optional number): Subtask item sort order
        • timeZone (optional string): Subtask timezone
        • status (optional number): Completion status (Normal: 0, Completed: 1)
        • completedTime (optional string): Completion time in "yyyy-MM-dd'T'HH:mm:ssZ" format
    • Returns: Created task object matching TickTickTaskSchema

  3. update_task

    • Update an existing task
    • Inputs:
      • taskId (string): Task identifier - Path
      • id (string): Task identifier - Body
      • projectId (string): Project id
      • All optional fields from create_task
    • Returns: Updated task object matching TickTickTaskSchema

  4. complete_task

    • Mark a task as completed
    • Inputs:
      • taskId (string): Task identifier
      • projectId (string): Project identifier
    • Returns: void

  5. delete_task

    • Delete a task from a project
    • Inputs:
      • taskId (string): Task identifier
      • projectId (string): Project identifier
    • Returns: void

  6. get_user_projects

    • Get all projects for the authenticated user
    • Inputs: None
    • Returns: Array of project objects matching TickTickProjectSchema

  7. get_project_by_id

    • Get a specific project by ID
    • Inputs:
      • projectId (string): Project identifier
    • Returns: Project object matching TickTickProjectSchema

  8. get_project_with_data

    • Get project details along with tasks and columns
    • Inputs:
      • projectId (string): Project identifier
    • Returns: Object containing:
      • project: Project object matching TickTickProjectSchema
      • tasks: Array of task objects matching TickTickTaskSchema
      • columns: Optional array of column objects with:
        • id (optional string)
        • projectId (optional string)
        • name (optional string)
        • sortOrder (optional number)

  9. create_project

    • Create a new project
    • Inputs:
      • name (string): Project name
      • color (optional string): Project color (default: '#4772FA')
      • viewMode (optional string): View mode ('list', 'kanban', 'timeline') (default: 'list')
      • kind (optional string): Project kind ('TASK', 'NOTE') (default: 'TASK')
    • Returns: Created project object matching TickTickProjectSchema

  10. update_project

    • Update an existing project
    • Inputs:
      • projectId (string): Project identifier
      • name (optional string): Project name
      • color (optional string): Project color
      • sortOrder (optional number): Project sort order
      • viewMode (optional string): View mode ('list', 'kanban', 'timeline')
      • kind (optional string): Project kind ('TASK', 'NOTE')
    • Returns: Updated project object matching TickTickProjectSchema

  11. delete_project

    • Delete a project
    • Inputs:
      • projectId (string): Project identifier
    • Returns: void

Schema References

  • TickTickTaskSchema: Defines the structure for task objects including:

    • Basic task properties (id, title, description)
    • Dates and time settings
    • Priority and status
    • Checklist items and subtasks

  • TickTickProjectSchema: Defines the structure for project objects including:

    • Project identification and naming
    • Display settings (color, view mode)
    • Permissions and organization

Tasks Properties

When creating or updating tasks, you can include these properties:

  • Priority Levels:
    • 0: None
    • 1: Low
    • 3: Medium
    • 5: High
  • Status Values:
    • 0: Normal (not completed)
    • 2: Completed
  • Reminder Format:
    • Example: ["TRIGGER:P0DT9H0M0S", "TRIGGER:PT0S"]
    • Follows iCalendar TRIGGER format
  • Recurring Rules (repeatFlag):
    • Example: "RRULE:FREQ=DAILY;INTERVAL=1"
    • Uses RFC 5545 recurrence rules
  • Date Format:
    • ISO 8601 format: "yyyy-MM-dd'T'HH:mm:ssZ"
    • Example: "2019-11-13T03:00:00+0000"

Projects Properties

When creating or updating projects, you can use these properties:

  • View Modes:
    • "list": Standard list view
    • "kanban": Kanban board view
    • "timeline": Timeline view
  • Project Kinds:
    • "TASK": Task-oriented project
    • "NOTE": Note-oriented project