TickTick

This TickTick MCP Server provides a live MCP interface to interact with TickTick data. It exposes standardized endpoints for streaming and management actions, enabling clients to list projects, fetch and manipulate tasks, and keep TickTick data in sync with your tools and automations.

How to use

You connect an MCP client to the server to perform common TickTick actions. Use the recommended HTTP transport to stream data from the MCP endpoint, or use the SSE transport if you prefer server-sent events. The available tools let you list projects and manage tasks across your TickTick workspace.

How to install

Prerequisites: you need Node.js and npm installed on your machine, and access to a TickTick API token.

1. Set up environment variables in your shell or environment manager.

2. Install dependencies for local development.

3. Run the development server to start the MCP locally.

# Install dependencies
npm install

# Set environment variables
export TICKTICK_ACCESS_TOKEN="your-token"
export REDIS_URL="your-redis-url"  # Optional for local

# Run development server
npm run dev

Configuration and endpoints

The server exposes two MCP endpoints you can use from clients:

• /api/mcp for Streamable HTTP transport (recommended)

• /api/sse for Server-Sent Events transport

Security and secrets

Keep your TickTick access token secure and do not commit it to source control. Use a secure environment manager in your deployment environment to inject TICKTICK_ACCESS_TOKEN and REDIS_URL when starting the server.

Troubleshooting tips

If you cannot connect from your MCP client, verify that the environment variables are set, the server is running, and the correct MCP URL is being used. Check that the Redis URL (REDIS_URL) is reachable if you are using SSE transport.

Notes

The MCP server supports commands to list TickTick projects, fetch tasks, and perform task creation, updates, completion, and deletion as exposed by the available tools.

Available tools

list_projects

List all TickTick projects.

get_tasks

Get tasks, either all or filtered by a specific project.

create_task

Create a new task within TickTick.

update_task

Update the details of an existing TickTick task.

complete_task

Mark a task as completed.

delete_task

Delete a task from TickTick.