ainishanov/ticktick-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

2 stars 5 forks Качество 76 Тренд 12MIT

Repository Install

Connect AI assistants to TickTick tasks

Обзор

TickTick MCP is a Model Context Protocol (MCP) server for TickTick. It lets Claude and other MCP clients read projects, find tasks, create tasks, and complete work from chat. - Ask what is due today. - Find overdue or high-priority tasks. - Create tasks and checklist items. - Update, complete, or delete tasks. - Manage TickTick projects. - 📁 - List all your TickTick projects/lists - 📁 - Get specific project details - 📁 - Get project with all tasks and kanban columns - ➕ - Create new projects with custom colors and view modes - ✏️ - Modify project settings - 🗑️ - Remove projects - ✅ - Retrieve tasks from all projects or a specific one - 📅 - Get tasks due today - ⚠️ - Get tasks past their due date - 🎯 - Get high/medium priority tasks - 🏷️ - Get tasks with specific tags - 🏷️ - List all unique tags - ➕ - Add new tasks with title, priority, due date - ➕ - Add tasks with checklist items - ➕ - Add subtask to existing task - ✔️ - Mark tasks as done - ✏️ - Modify existing tasks -...

README

Показан фрагмент оригинального README. Открыть оригинал.

TickTick MCP Server

Connect AI assistants to TickTick.

TickTick MCP is a Model Context Protocol (MCP) server for TickTick. It lets Claude and other MCP clients read projects, find tasks, create tasks, and complete work from chat.

What You Can Do

Ask what is due today.
Find overdue or high-priority tasks.
Create tasks and checklist items.
Update, complete, or delete tasks.
Manage TickTick projects.

Features

Project Management

📁 Get Projects - List all your TickTick projects/lists
📁 Get Project by ID - Get specific project details
📁 Get Project with Data - Get project with all tasks and kanban columns
➕ Create Project - Create new projects with custom colors and view modes
✏️ Update Project - Modify project settings
🗑️ Delete Project - Remove projects

Task Queries

✅ Get Tasks - Retrieve tasks from all projects or a specific one
📅 Today’s Tasks - Get tasks due today
⚠️ Overdue Tasks - Get tasks past their due date
🎯 Priority Filter - Get high/medium priority tasks
🏷️ Filter by Tag - Get tasks with specific tags
🏷️ Get All Tags - List all unique tags

Task Management

➕ Create Tasks - Add new tasks with title, priority, due date
➕ Create with Subtasks - Add tasks with checklist items
➕ Add Subtask - Add subtask to existing task
✔️ Complete Tasks - Mark tasks as done
✏️ Update Tasks - Modify existing tasks
🗑️ Delete Tasks - Remove tasks

Installation

Option 1: pip install (recommended)

pip install ticktick-mcp

Option 2: From source

git clone https://github.com/ainishanov/ticktick-mcp.git
cd ticktick-mcp
pip install -e .

Setup

1. Get TickTick API Access Token

Go to TickTick Developer Portal
Create a new application
Complete OAuth2 flow to get your access token
Copy the access token

2. Configure Environment

Create a .env file in the project directory:

cp .env.example .env

Edit .env and add your token:

TICKTICK_ACCESS_TOKEN=your_access_token_here

3. Configure MCP clients

pip install adds ticktick-mcp to your Python environment, so cwd is typically not required. For source checkouts, set cwd to /path/to/ticktick-mcp/src so Python can import ticktick_mcp from the local source tree.

3a. Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "ticktick": {
      "command": "python",
      "args": ["-m", "ticktick_mcp.server"],
      "env": {
        "TICKTICK_ACCESS_TOKEN": "your_access_token_here"
      }
    }
  }
}