TickTick MCP Server

Features

• View all your TickTick projects and tasks

• Create new projects and tasks through natural language

• Update existing task details (title, content, dates, priority)

• Mark tasks as complete

• Delete tasks and projects

• Full integration with TickTick's open API

• Seamless integration with Claude and other MCP clients

Prerequisites

• Python 3.10 or higher

• uv - Fast Python package installer and resolver

• TickTick account with API access

• TickTick API credentials (Client ID, Client Secret, Access Token)

Installation

1. Clone this repository:

2. Install with uv:

3. Authenticate with TickTick:This will:

4. Test your configuration:This will verify that your TickTick credentials are working correctly.

Authentication with TickTick

1. Register your application at the TickTick Developer Center

2. Run the authentication command:

3. Follow the prompts to enter your Client ID and Client Secret

4. A browser window will open for you to authorize the application with your TickTick account

5. After authorizing, you'll be redirected back to the application, and your access tokens will be automatically saved to the .env file

Usage with Claude for Desktop

1. Install Claude for Desktop

2. Edit your Claude for Desktop configuration file:macOS:Windows:

3. Add the TickTick MCP server configuration, using absolute paths:

4. Restart Claude for Desktop

Available MCP Tools

Example Prompts for Claude

• "Show me all my TickTick projects"

• "Create a new task called 'Finish MCP server documentation' in my work project with high priority"

• "List all tasks in my personal project"

• "Mark the task 'Buy groceries' as complete"

• "Create a new project called 'Vacation Planning' with a blue color"

• "When is my next deadline in TickTick?"

Development

Project Structure

Authentication Flow

1. Initial Setup: User provides their TickTick API Client ID and Secret

2. Browser Authorization: User is redirected to TickTick to grant access

3. Token Reception: A local server receives the OAuth callback with the authorization code

4. Token Exchange: The code is exchanged for access and refresh tokens

5. Token Storage: Tokens are securely stored in the local .env file

6. Token Refresh: The client automatically refreshes the access token when it expires

Contributing

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

TickTick MCP Server

Features

• View all your TickTick projects and tasks

• Create new projects and tasks through natural language

• Update existing task details (title, content, dates, priority)

• Mark tasks as complete

• Delete tasks and projects

• Full integration with TickTick's open API

• Seamless integration with Claude and other MCP clients

Prerequisites

• Python 3.10 or higher

• uv - Fast Python package installer and resolver

• TickTick account with API access

• TickTick API credentials (Client ID, Client Secret, Access Token)

Installation

1. Clone this repository:

2. Install with uv:

3. Authenticate with TickTick:This will:

4. Test your configuration:This will verify that your TickTick credentials are working correctly.

Authentication with TickTick

1. Register your application at the TickTick Developer Center

2. Run the authentication command:

3. Follow the prompts to enter your Client ID and Client Secret

4. A browser window will open for you to authorize the application with your TickTick account

5. After authorizing, you'll be redirected back to the application, and your access tokens will be automatically saved to the .env file

Usage with Claude for Desktop

1. Install Claude for Desktop

2. Edit your Claude for Desktop configuration file:macOS:Windows:

3. Add the TickTick MCP server configuration, using absolute paths:

4. Restart Claude for Desktop

Available MCP Tools

Example Prompts for Claude

• "Show me all my TickTick projects"

• "Create a new task called 'Finish MCP server documentation' in my work project with high priority"

• "List all tasks in my personal project"

• "Mark the task 'Buy groceries' as complete"

• "Create a new project called 'Vacation Planning' with a blue color"

• "When is my next deadline in TickTick?"

Development

Project Structure

Authentication Flow

1. Initial Setup: User provides their TickTick API Client ID and Secret

2. Browser Authorization: User is redirected to TickTick to grant access

3. Token Reception: A local server receives the OAuth callback with the authorization code

4. Token Exchange: The code is exchanged for access and refresh tokens

5. Token Storage: Tokens are securely stored in the local .env file

6. Token Refresh: The client automatically refreshes the access token when it expires

Contributing

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License