TickTick Mcp V2

TickTick MCP v2
A Model Context Protocol (MCP) server for TickTick that enables interacting with your TickTick task management system directly through Claude and other MCP clients using v2 interfaces.

Project Purpose
This project addresses two key challenges in the current TickTick MCP landscape:

Complex Authentication: The v1 interface requires overly complex authentication methods, which are not as straightforward as direct username/password authentication.

Limited API Functionality: The official v1 API interfaces provide limited functionality and make it cumbersome to implement more complex features. For example, other TickTick MCP implementations cannot even retrieve tasks from the Inbox.

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
🔐 Username/password authentication with local credential storage
Quick Start
Create a mcp.json file:

{
"mcpServers": {
"ticktick-mcp-v2": {
"command": "uvx",
"args": ["--from", "ticktick-mcp-v2", "ticktick-mcp", "run"],
"env": {
"TICKTICK_USERNAME": "your_username",
"TICKTICK_PASSWORD": "your_password"
}
}
}
}
Start Using
You can now interact with your TickTick tasks directly! Try asking:

"Show me all my TickTick projects"
"Create a task called 'Finish documentation' with high priority"
"What tasks do I have due today?"
Development Setup
Install and authenticate:

uvx --from ticktick-mcp-v2 ticktick-mcp auth
Test the connection:

uvx --from ticktick-mcp-v2 ticktick-mcp test
Run the server:

uvx --from ticktick-mcp-v2 ticktick-mcp run
Usage Examples
Using with other MCP clients
Any MCP-compatible client can connect using the configuration above.

Available MCP Tools
Tool Description Parameters
Authentication
auth_status Check authentication status None
Project Management
get_projects List all projects None
get_project Get project details project_id
create_project Create new project name, color (optional), view_mode (optional)
delete_project Delete project project_id
get_project_tasks Get tasks in project project_id, include_completed (optional)
Task Management
get_tasks List all tasks include_completed (optional)
create_task Create new task title, project_id (optional), content (optional), start_date (optional), due_date (optional), priority (optional)
update_task Update task task_id, project_id (optional), title (optional), content (optional), start_date (optional), due_date (optional), priority (optional)
delete_task Delete task project_id, task_id
complete_task Mark task complete task_id
Advanced Features
search_tasks Search tasks query
get_tasks_by_priority Get tasks by priority priority (0=None, 1=Low, 3=Medium, 5=High)
get_tasks_due_today Get tasks due today None
get_overdue_tasks Get overdue tasks None
Example Prompts
"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"

TickTick MCP v2
一个用于 TickTick 的模型上下文协议(MCP)服务器，允许您通过 Claude 和其他 MCP 客户端使用 v2 接口直接与您的 TickTick 任务管理系统进行交互。

项目目的
本项目旨在解决当前 TickTick MCP 领域的两个问题：

复杂的身份验证：v1 接口需要的身份验证方法过于繁杂，不如直接的账户密码。

有限的API功能：官方提供的 v1 API 接口，这些接口提供的功能有限，实现更复杂的功能比较繁琐。比如另外一个 ticktick mcp 甚至不能获取 Inbox 中的任务。

功能特性
📋 查看所有您的 TickTick 项目和任务
✏️ 通过自然语言创建新项目和任务
🔄 更新现有任务详情（标题、内容、日期、优先级）
✅ 将任务标记为完成
🗑️ 删除任务和项目
🔐 用户名/密码身份验证，本地凭证存储
快速开始
mcp.json 文件：

{
"mcpServers": {
"ticktick-mcp-v2": {
"command": "uvx",
"args": ["--from", "ticktick-mcp-v2", "ticktick-mcp", "run"],
"env": {
"TICKTICK_USERNAME": "your_username",
"TICKTICK_PASSWORD": "your_password"
}
}
}
}
4. 开始使用
现在您可以直接与您的TickTick任务进行交互！试试询问：

"显示我所有的 TickTick 项目"
"创建一个名为'完成文档'的高优先级任务"
"我今天有哪些到期的任务？"
开发方案
安装和身份验证：

uvx --from ticktick-mcp-v2 ticktick-mcp auth
测试连接：

uvx --from ticktick-mcp-v2 ticktick-mcp test
运行服务器：

uvx --from ticktick-mcp-v2 ticktick-mcp run
使用示例
使用其他MCP客户端
任何MCP兼容的客户端都可以使用上述配置进行连接。

可用的MCP工具
工具 描述 参数
身份验证
auth_status 检查身份验证状态 无
项目管理
get_projects 列出所有项目 无
get_project 获取项目详情 project_id
create_project 创建新项目 name, color (可选), view_mode (可选)
delete_project 删除项目 project_id
get_project_tasks 获取项目中的任务 project_id, include_completed (可选)
任务管理
get_tasks 列出所有任务 include_completed (可选)
create_task 创建新任务 title, project_id (可选), content (可选), start_date (可选), due_date (可选), priority (可选)
update_task 更新任务 task_id, project_id (可选), title (可选), content (可选), start_date (可选), due_date (可选), priority (可选)
delete_task 删除任务 project_id, task_id
complete_task 标记任务完成 task_id
高级功能
search_tasks 搜索任务 query
get_tasks_by_priority 按优先级获取任务 priority (0=无, 1=低, 3=中, 5=高)
get_tasks_due_today 获取今日到期任务 无
get_overdue_tasks 获取逾期任务 无
示例提示
"显示我所有的 TickTick 项目"
"创建一个名为'完成文档'的高优先级任务"
"我今天有哪些到期的任务？"
"将任务'买杂货'标记为完成"
"更新任务'会议记录'的到期日期为明天"