ticktick-mcp-server

rafliruslan/ticktick-mcp-server

3.3

If you are the rightful owner of ticktick-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Model Context Protocol (MCP) server that integrates with the TickTick task management service.

The TickTick MCP Server is a robust integration tool designed to seamlessly connect with the TickTick task management service. It offers a comprehensive suite of features that allow users to manage their tasks and projects efficiently. With capabilities such as listing tasks and projects, creating, updating, and deleting tasks, and marking tasks as completed, this server provides a full-fledged task management experience. It also includes advanced timezone handling to ensure accurate due date calculations, making it particularly useful for users across different time zones. The server supports both OAuth and username/password authentication, ensuring secure access to TickTick services. Built with TypeScript, it ensures type safety and robust error handling, making it a reliable choice for developers.

Features

  • List tasks and projects with enhanced display (human-readable priorities)
  • Create, update, and delete tasks
  • Mark tasks as completed
  • Get specific task details
  • Timezone handling with manual D+1 adjustment for accurate due date calculations

Usages

usage with Claude Desktop

{
  "mcpServers": {
    "ticktick": {
      "command": "node",
      "args": ["/path/to/ticktick-mcp-server/dist/index.js"],
      "env": {
        "TICKTICK_ACCESS_TOKEN": "your_oauth_token",
        "TICKTICK_REFRESH_TOKEN": "your_refresh_token",
        "TICKTICK_CLIENT_ID": "your_client_id",
        "TICKTICK_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

usage with Cursor IDE

{
  "mcp": {
    "servers": {
      "ticktick": {
        "command": "node",
        "args": ["/path/to/ticktick-mcp-server/dist/index.js"],
        "env": {
          "TICKTICK_ACCESS_TOKEN": "your_oauth_token",
          "TICKTICK_REFRESH_TOKEN": "your_refresh_token",
          "TICKTICK_CLIENT_ID": "your_client_id",
          "TICKTICK_CLIENT_SECRET": "your_client_secret"
        }
      }
    }
  }
}

alternative with Username Password

{
  "env": {
    "TICKTICK_USERNAME": "your_username",
    "TICKTICK_PASSWORD": "your_password"
  }
}

Tools

  1. get_tasks

    Get all tasks or tasks from a specific project (with enhanced display)

  2. get_overdue_tasks

    Get overdue tasks with timezone compensation (configurable offset, defaults to UTC+8)

  3. get_todays_tasks

    Get tasks due today with D+1 timezone adjustment

  4. get_projects

    Get all projects from TickTick

  5. create_task

    Create a new task with priority, tags, due dates

  6. update_task

    Update an existing task

  7. delete_task

    Delete a task

  8. complete_task

    Mark a task as completed

  9. get_task

    Get a specific task by ID