TickTick MCP Server Integration

What does “TickTick” MCP Server do?

The TickTick MCP Server is a Model Context Protocol (MCP) server designed to integrate AI assistants and LLM-enabled tools with the TickTick task management platform. By exposing TickTick’s functions via MCP, it enables intelligent, context-aware task operations and workflow automation. Developers and AI clients can leverage this server to programmatically manage tasks, projects, and subtasks—such as creating, updating, or completing tasks—while taking advantage of TickTick’s organizational features. The server supports secure OAuth2 authentication and provides robust error handling, making it suitable for streamlining personal productivity, automating repetitive workflows, and integrating TickTick data directly into other AI-powered platforms or development environments.

List of Prompts

No prompt templates are mentioned in the available documentation or codebase.

List of Resources

No explicit MCP resources are listed in the available documentation or codebase.

List of Tools

• get_task_by_ids

  • Retrieves a specific task by project ID and task ID. Returns a detailed Task object according to the TickTickTaskSchema.

• create_task

  • Creates a new task within a specified project. Supports setting the title, content, description, dates, reminders, priority, and subtasks.

• update_task

  • Updates an existing task in a project. Allows modification of all properties available during creation, including task and project identifiers.

• complete_task

  • Marks a specified task as completed within a project.

Use Cases of this MCP Server

• Task Automation
  • Programmatically create and update tasks, enabling AI agents to automate personal or team task management routines.
• Project Organization
  • Automatically manage projects, including organizing and updating tasks and subtasks for better workflow tracking.
• Habit Tracking
  • Use AI to analyze and update recurring or habit-based tasks for users, supporting productivity and goal tracking.
• Integration with Other Tools
  • Bridge TickTick with other productivity or AI tools, allowing seamless data flow and centralized task operations.
• Context-Aware Reminders
  • Enable AI to set, update, or complete tasks based on contextual signals or user behavior, enhancing smart reminders and notifications.

How to set it up

Windsurf

1. Ensure Node.js is installed on your system.
2. Locate your Windsurf configuration file (e.g., config.json).
3. Add the TickTick MCP Server entry to your mcpServers section:

   {
     "mcpServers": {
       "ticktick-mcp": {
         "command": "npx",
         "args": ["@alexarevalo9/ticktick-mcp-server@latest"]
       }
     }
   }
   

4. Save your configuration file and restart Windsurf.
5. Verify that the TickTick MCP Server is running and accessible.

Securing API Keys:

{
  "mcpServers": {
    "ticktick-mcp": {
      "command": "npx",
      "args": ["@alexarevalo9/ticktick-mcp-server@latest"],
      "env": {
        "TICKTICK_CLIENT_ID": "your-client-id",
        "TICKTICK_CLIENT_SECRET": "your-client-secret"
      },
      "inputs": {}
    }
  }
}

Claude

1. Install Node.js if not already present.
2. Locate Claude’s MCP configuration file.
3. Add the TickTick MCP Server using the following snippet:

   {
     "mcpServers": {
       "ticktick-mcp": {
         "command": "npx",
         "args": ["@alexarevalo9/ticktick-mcp-server@latest"]
       }
     }
   }
   

4. Save and restart Claude.
5. Confirm the MCP server is available.

Cursor

1. Install Node.js as a prerequisite.
2. Open Cursor’s configuration panel or file.
3. Include the TickTick MCP Server in the mcpServers section:

   {
     "mcpServers": {
       "ticktick-mcp": {
         "command": "npx",
         "args": ["@alexarevalo9/ticktick-mcp-server@latest"]
       }
     }
   }
   

4. Save and restart Cursor.
5. Check connectivity to the MCP server.

Cline

1. Make sure Node.js is installed.
2. Edit Cline’s MCP configuration file.
3. Insert the TickTick MCP Server configuration:

   {
     "mcpServers": {
       "ticktick-mcp": {
         "command": "npx",
         "args": ["@alexarevalo9/ticktick-mcp-server@latest"]
       }
     }
   }
   

4. Save your changes and restart Cline.
5. Test the setup to ensure the MCP server is functional.

Note: For all platforms, secure sensitive credentials like API keys using environment variables in your configuration as shown above.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "ticktick-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “ticktick-mcp” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Based on the above, TickTick MCP Server provides solid task management integration and tooling, but lacks visible prompt templates, explicit resource exposure, and sampling/roots documentation. Its configuration and tool documentation are clear, but the absence of prompt/resource definitions and advanced MCP features may limit extensibility for some users.

MCP Score

Our opinion:
TickTick MCP Server is well-documented for its primary tools but lacks advanced MCP features and licensing clarity. It rates a 5/10 for general MCP usability and openness, as it covers basics but omits prompt/resource extensibility and legal use clarity.