TickTick MCP

TickTick MCP

MCP server for AI-powered TickTick task management integration

View on GitHub
6
Stars
6
Forks
6
Watchers
1
Issues
TickTick MCP is a Model Context Protocol (MCP) server that enables standardized integration of TickTick's task management features with AI assistants and developer applications. It allows programmatic access to create, update, retrieve, complete, or delete tasks and projects in TickTick via Python. Using this MCP server, AI systems can leverage TickTick's API to help automate and manage user's to-do lists and projects through natural language or other interfaces.

Key Features

Standardized Model Context Protocol (MCP) server implementation
Integration with TickTick's task and project management APIs
Supports retrieval, creation, updating, completion, and deletion of tasks
Python-based server for easy installation and extension
OAuth2 authentication with TickTick
Provides multiple tools for granular task and project operations
Natural language command support via MCP-compatible clients
OpenAPI support for secure app registration
Environment variable configuration support
Extensible toolset with customizable actions

Use Cases

Automating personal to-do list management via AI assistants
Integrating TickTick with AI-powered productivity applications
Using natural language to manage tasks and projects
Syncing TickTick data with custom workflow tools
Creating or completing tasks remotely via connected MCP clients
Automating routine project organization with scripts
Centralizing task management from multiple sources
Leveraging TickTick functionality inside code editors or IDEs
Building custom productivity bots for TickTick
Providing unified task management access to multiple AI or automation platforms

README

TickTick MCP

A Model Context Protocol (MCP) server that provides tools for integrating TickTick task management tools. Using Python and the MCP SDK.

Overview

This repository contains a Model Context Protocol (MCP) server implementation for TickTick. It provides a standardized way for AI assistants and applications to interact with TickTick's task management functionality, allowing operations like:

  • Retrieving projects and tasks
  • Creating new projects and tasks
  • Updating task details
  • Completing and deleting tasks

With this MCP, AI systems can act as task masters to help manage your to-do lists and tasks in TickTick with natural language.

Requirements

  • Python 3.8+
  • TickTick account
  • TickTick API key (via OAuth) # COMMENT: I will add a tool to generate an API key from the TickTick developer portal

Installation

  1. Clone this repository

    bash
    git clone https://github.com/ekkyarmandi/ticktick-mcp.git
cd ticktick-mcp

  2. Install dependencies

    bash
    pip install -r requirements.txt

Obtaining a TickTick API Key

This MCP uses TickTick's OpenAPI scheme, which requires registering an app through TickTick's developer portal:

  1. Go to the TickTick Developer Documentation
  2. Click on Manage Apps in the top right corner and login with your TickTick credentials
  3. Register a new app by clicking the +App Name button
  4. Enter a name for your app (only required field)
  5. Once created, you'll be able to see your Client ID and Client Secret
  6. For the OAuth Redirect URL, enter a URL where you'll be redirected after authorization (e.g., http://127.0.0.1:8080)

Authorizing Your App

After registering your app, use the ticktick-py library to get your access token:

python
from ticktick.oauth2 import OAuth2

# Replace with your details from the developer portal
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"
redirect_uri = "YOUR_REDIRECT_URI"  # e.g., http://127.0.0.1:8080

auth_client = OAuth2(client_id=client_id,
                    client_secret=client_secret,
                    redirect_uri=redirect_uri)

# This will open a web browser for authorization
# Follow the instructions in the terminal to authorize
auth_client.get_access_token()

After authorizing, the access token will be saved to a .token-oauth file by default. You can extract the token from this file or use:

python
print(auth_client.token_info["access_token"])

Configuration

  1. Create a .env file in the root directory with your TickTick API key: 
    TICKTICK_API_KEY=your_access_token_here

Usage

Run the MCP server:

bash
python main.py

This will start the MCP server on port 8000. You can now connect to it using any MCP client.

Available Tools

The server provides the following tools:

  • get_projects: Get a list of all projects
  • project_details: Get details of a specific project
  • get_task_details: Get details of a specific task
  • create_project: Create a new project
  • create_task: Create a new task in a project
  • update_task: Update an existing task
  • complete_task: Mark a task as complete
  • delete_task: Delete a task

Example Interactions

Once your MCP server is running, AI systems can help manage your tasks with natural language commands like:

  • "Show me all my projects"
  • "Create a new project called 'Home Renovation'"
  • "Add a task to buy groceries tomorrow"
  • "Mark my 'Pay bills' task as complete"
  • "What tasks do I have due this week?"
  • "Delete the task about the canceled meeting"

Using with MCP Clients

This server can be used with any MCP-compatible client, such as:

  • Claude Desktop
  • Cursor IDE
  • Custom AI applications using MCP SDKs

Development

To extend or modify this MCP server:

  1. Add new tools in tools.py
  2. Register them in main.py using mcp.add_tool()

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Star History

Star History Chart

Repository Owner

ekkyarmandi

Repository Details

Language Python
Default Branch master
Size 9 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Task Management productivity Python API integration automation

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • TickTick MCP Server

    TickTick MCP Server

    Enable powerful AI-driven task management for TickTick via the Model Context Protocol.

    TickTick MCP Server provides comprehensive programmatic access to TickTick task management features using the Model Context Protocol. Built on the ticktick-py library, it enables AI assistants and MCP-compatible applications to create, update, retrieve, and filter tasks with improved precision and flexibility. The server supports advanced filtering, project and tag management, subtask handling, and robust context management for seamless AI integration.

    • ⭐ 35
    • MCP
    • jen6/ticktick-mcp
  • anki-mcp

    anki-mcp

    MCP server for seamless integration with Anki via AnkiConnect.

    An MCP server that bridges Anki flashcards with the Model Context Protocol, exposing AnkiConnect functionalities as standardized MCP tools. It organizes Anki actions into intuitive services covering decks, notes, cards, and models for easy access and automation. Designed for integration with AI assistants and other MCP-compatible clients, it enables operations like creating, modifying, and organizing flashcards through a unified protocol.

    • ⭐ 6
    • MCP
    • ujisati/anki-mcp
  • MyMCP Server (All-in-One Model Context Protocol)

    MyMCP Server (All-in-One Model Context Protocol)

    Powerful and extensible Model Context Protocol server with developer and productivity integrations.

    MyMCP Server is a robust Model Context Protocol (MCP) server implementation that integrates with services like GitLab, Jira, Confluence, YouTube, Google Workspace, and more. It provides AI-powered search, contextual tool execution, and workflow automation for development and productivity tasks. The system supports extensive configuration and enables selective activation of grouped toolsets for various environments. Installation and deployment are streamlined, with both automated and manual setup options available.

    • ⭐ 93
    • MCP
    • nguyenvanduocit/all-in-one-model-context-protocol
  • Things MCP Server

    Things MCP Server

    Seamless Model Context Protocol integration for managing Things app todos and projects.

    Things MCP Server enables AI assistants to interact with the Things productivity app using the Model Context Protocol (MCP). It offers comprehensive support for Things' URL scheme, allowing creation, updating, and management of todos and projects through standardized commands. The server supports batch operations, advanced organization features, and natural language scheduling, making task automation efficient for MCP-compatible clients.

    • ⭐ 6
    • MCP
    • jimfilippou/things-mcp
  • MCP Linear

    MCP Linear

    MCP server for AI-driven control of Linear project management.

    MCP Linear is a Model Context Protocol (MCP) server implementation that enables AI assistants to interact with the Linear project management platform. It provides a bridge between AI systems and the Linear GraphQL API, allowing the retrieval and management of issues, projects, teams, and more. With MCP Linear, users can create, update, assign, and comment on Linear issues, as well as manage project and team structures directly through AI interfaces. The tool supports seamless integration via Smithery and can be configured for various AI clients like Cursor and Claude Desktop.

    • ⭐ 117
    • MCP
    • tacticlaunch/mcp-linear
  • Plane MCP Server

    Plane MCP Server

    Enables LLMs to manage Plane.so projects and issues via the Model Context Protocol.

    Plane MCP Server provides a standardized interface to connect large language models with Plane.so project management APIs. It enables LLMs to interact directly with project and issue data, supporting tasks such as listing projects, retrieving detailed information, creating and updating issues, while prioritizing user control and security. Installation is streamlined through tools like Smithery, and configuration supports multiple clients including Claude for Desktop.

    • ⭐ 32
    • MCP
    • kelvin6365/plane-mcp-server
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results