このMCPサーバーでTickTickワークフローを強化します。 [ticktick-py ライブラリ上に構築されたライブラリは、AI アシスタントと MCP 互換アプリケーション (Claude デスクトップ、VS コード エージェント モード、または [mcp-use]]]) が大幅に改善されたフィルタリング機能を提供します。

✨ 機能

このサーバーは、MCP ツールを使用して TickTick 機能に包括的なアクセスを提供し、次のように分類します。

***タスク管理:**作成、更新(TickTickの日付形式への変換を含む)、削除、完了、タスクの移動。 *サブタスク管理: 既存のタスクをリンクすることでサブタスクを作成します。 *タスクの検索:

• 未完成のタスクをすべて取得します。 ※IDまたは特定のフィールドでタスクを取得する *日付範囲内で完了したタスクを取得します。
• 特定のプロジェクトからタスクを取得します。
• 様々なクリッゲリア(優先順位、プロジェクト、タグなど)に基づいてタスクをフィルタリングします。 プロジェクト/タグ管理: すべてのプロジェクト、タグ、プロジェクトフォルダを取得します。 *** ヘルパーツール:* datetime 文字列を必要な TickTick 形式に変換します。

詳細な仕様の[src/ticktick_mcp/tools/ディレクトリ内のツール定義を参照してください。

OST 始める

TickTick MCP Server

Enhance your TickTick workflow with this MCP server. Built upon the ticktick-py library, it offers significantly improved filtering capabilities, allowing AI assistants and MCP-compatible applications (like Claude Desktop, VS Code Agent Mode, or mcp-use) to interact with your tasks with greater precision and power.

✨ Features

This server provides comprehensive access to TickTick functionalities via MCP tools, categorized as follows:

• Task Management: Create, update (including conversion to TickTick’s date format), delete, complete, and move tasks.
• Subtask Management: Create subtasks by linking existing tasks.
• Task Retrieval:
  • Get all uncompleted tasks.
  • Get tasks by ID or specific fields.
  • Get completed tasks within a date range.
  • Get tasks from a specific project.
  • Filter tasks based on various critggeria (priority, project, tags, etc.).
• Project/Tag Management: Retrieve all projects, tags, and project folders.
• Helper Tools: Convert datetime strings to the required TickTick format.

Refer to the tool definitions within the src/ticktick_mcp/tools/ directory for detailed specifications.

🚀 Getting Started

This server utilizes the unofficial ticktick-py library to interact with the TickTick API.

Prerequisites

• Python >= 3.10
• Access to TickTick and API credentials (see below).

Setup

1. Register a TickTick Application: Before using the server, you need to register an application with TickTick to obtain API credentials. Follow these steps based on the ticktick-py documentation:

   • Go to the TickTick OpenAPI Documentation and log in with your TickTick account.
   • Click on Manage Apps in the top right corner.
   • Register a new app by clicking the +App Name button. Provide a name for your application (e.g., “MCP Server”).
   • Once created, edit the app details. Note down the generated Client ID and Client Secret.
   • For the OAuth Redirect URL, enter a URL where you want to be redirected after authorizing the application. It doesn’t need to be a live URL
     • http://localhost:8080/redirect or http://127.0.0.1:8080/ are common choices for local development.
     • Ensure this exact URL is saved in your environment variables.

2. Environment Variables: The server requires the TickTick API credentials you just obtained, plus your TickTick login details. By default, it looks for a .env file located at ~/.config/ticktick-mcp/.env.