TickTick

Provides MCP access to TickTick actions: view, create, update, complete, and delete tasks and projects via username/password authentication.

javascript

1

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "yidianyiko-ticktick-mcp-v2": {
      "command": "uvx",
      "args": [
        "--from",
        "ticktick-mcp-v2",
        "ticktick-mcp",
        "run"
      ],
      "env": {
        "TICKTICK_PASSWORD": "YOUR_PASSWORD",
        "TICKTICK_USERNAME": "YOUR_USERNAME"
      }
    }
  }
}

You can connect to TickTick through an MCP v2 server to manage your tasks and projects directly from Claude or other MCP clients. This setup provides easy username/password authentication and a rich set of capabilities to view, create, update, and delete items, all via MCP endpoints.

How to use

After starting the MCP server, you interact with TickTick tasks using natural language prompts through your MCP client. You can ask to view all projects, create new tasks, update details like titles and due dates, mark tasks as complete, or delete tasks and projects. The server authenticates with your TickTick credentials and then exposes a range of actions you can perform via the MCP interface.

How to install

Prerequisites: you need Node.js and access to run MCP commands in your environment. You will also use the uvx tool to run MCP servers.

Create a configuration file named mcp.json with the TickTick MCP v2 server configuration.

{
  "mcpServers": {
    "ticktick-mcp-v2": {
      "command": "uvx",
      "args": ["--from", "ticktick-mcp-v2", "ticktick-mcp", "run"],
      "env": {
        "TICKTICK_USERNAME": "your_username",
        "TICKTICK_PASSWORD": "your_password"
      }
    }
  }
}

Additional configuration and running notes

You will start the server using the runtime command shown in your configuration. The environment variables should contain your TickTick username and password for direct authentication.

Example prompts you can try after the server is running include:

Show me all my TickTick projects
Create a task called 'Finish documentation' with high priority
What tasks do I have due today?
Mark the task 'Buy groceries' as complete
Update task 'Meeting notes' with new due date tomorrow

Available tools

auth_status

Check authentication status with the TickTick MCP server.

get_projects

List all TickTick projects.

get_project

Get details for a specific project by project_id.

create_project

Create a new project with a given name and optional color/view_mode.

delete_project

Delete a project by project_id.

get_project_tasks

Retrieve tasks within a specific project, optionally including completed tasks.

get_tasks

List all tasks, with an option to include completed tasks.

create_task

Create a new task with a title and optional project_id, content, dates, and priority.

update_task

Update details of an existing task identified by task_id.

delete_task

Delete a task by project_id and task_id.

complete_task

Mark a task as complete by task_id.

search_tasks

Search tasks by a query string.

get_tasks_by_priority

Get tasks filtered by priority levels.

get_tasks_due_today

List tasks due today.

get_overdue_tasks

List overdue tasks.