关键词

TickTick任务管理习惯追踪生产力工具Python SDK

项目简介

这是一个专为TickTick任务管理应用设计的Python SDK，同时集成了Model Context Protocol (MCP) 服务器功能，允许AI助手（如Claude）通过自然语言管理您的任务系统。

主要功能

  • 45个MCP工具：覆盖TickTick所有核心功能
  • 任务管理：创建、读取、更新、删除、完成任务
  • 项目管理：创建和管理项目、文件夹
  • 标签系统：层级标签管理，支持颜色定制
  • 习惯追踪：完整的习惯CRUD操作，包括打卡、连续记录和目标设定
  • 专注/番茄钟：访问专注会话数据和统计信息
  • 用户分析：生产力分数、等级、完成率统计

安装步骤

# 从PyPI安装
pip install ticktick-sdk

# 从源码安装（开发模式）
git clone https://github.com/dev-mirzabicer/ticktick-sdk.git
cd ticktick-sdk
pip install -e ".[dev]"

服务器配置

在MCP客户端（如Claude Desktop）配置文件中添加：

{
  "mcpServers": {
    "ticktick": {
      "command": "ticktick-sdk",
      "env": {
        "TICKTICK_CLIENT_ID": "您的客户端ID",
        "TICKTICK_CLIENT_SECRET": "您的客户端密钥",
        "TICKTICK_ACCESS_TOKEN": "您的访问令牌",
        "TICKTICK_USERNAME": "您的TickTick邮箱",
        "TICKTICK_PASSWORD": "您的TickTick密码"
      }
    }
  }
}

参数说明：

  • 'command': 服务器启动命令，使用"ticktick-sdk"
  • 'env': 包含认证所需的所有环境变量

基本使用方法

  1. 在TickTick开发者门户注册应用，获取客户端ID和密钥
  2. 运行认证脚本获取访问令牌
  3. 在客户端配置文件中填入您的TickTick账户信息和API凭证
  4. 启动MCP客户端后，即可通过自然语言管理您的任务，例如：
    • "我今天有哪些任务要完成？"
    • "创建一个明天下午2点给约翰打电话的任务"
    • "显示我的高优先级任务"
    • "完成购物任务"
    • "我的运动习惯当前连续打卡多少天？"

配置完成后，AI助手就可以帮助您：

  • 查看待办事项和截止时间
  • 创建新任务并设置提醒
  • 管理项目和标签
  • 追踪习惯打卡和连续记录

信息

分类

生产力应用

访问项目