ticktick-mcp-server 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cf9d114f051a0ddae817d5e1cc84a622bfbb057ee97cd8a1c68008bba0929833
+  data.tar.gz: 2678932d002e8c15e769fecb194c436fb69f0e7033dedd66fe8e10ccd39ed6b7
+SHA512:
+  metadata.gz: 4610d280cf0ff4c90fe73542abdb1b2960c3ab8ca0c79c87c7e3ad5cdb6cd03518b51a96934a0c4c0f24143757a1a85fea2667eb8032fd41dae587fb701e44be
+  data.tar.gz: 8d972718c6c3f0d12fc028f0a61bccb5c3083e509e35863e9a9cc46877dd9e77832b64bb108c28d73dff8c9ffff7e6be6c2634b169aaee7dee622380a290ff99

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.rubocop.yml

@@ -0,0 +1,23 @@
+AllCops:
+  TargetRubyVersion: 3.1
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Style/Documentation:
+  Enabled: false
+
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*_spec.rb"
+
+Metrics/ParameterLists:
+  Exclude:
+    - "lib/ticktick/resources/task_attributes.rb"
+    - "lib/ticktick/resources/project_resource.rb"
+    - "lib/ticktick/mcp/server/tools/project/create_project.rb"
+    - "lib/ticktick/mcp/server/tools/project/update_project.rb"
+    - "lib/ticktick/mcp/server/tools/task/create_task.rb"

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## [0.1.0] - 2026-02-21
+
+### Added
+- MCP server providing tools to interact with the TickTick Open API
+- Project management tools: list_projects, get_project, get_project_data, create_project, update_project, delete_project
+- Task management tools: list_all_tasks, create_task, update_task, complete_task, delete_task

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 j-o-lantern0422
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,102 @@
+# ticktick-mcp-server
+
+A Ruby gem that exposes the [TickTick Open API](https://developer.ticktick.com/) as an [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server. This allows LLMs like Claude to manage your TickTick projects and tasks directly.
+
+## Requirements
+
+- Ruby >= 3.1.0
+- A TickTick account with an Open API access token
+
+## Installation
+
+Clone the repository and install the gem locally:
+
+```bash
+git clone https://github.com/j-o-lantern0422/ticktick-mcp-server
+cd ticktick-mcp-server
+bundle install
+bundle exec rake install
+```
+
+## Configuration
+
+Set the following environment variable with your TickTick Open API access token:
+
+```
+TICKTICK_ACCESS_TOKEN=your_access_token_here
+```
+
+You can obtain an access token from the TickTick Open API developer settings.
+
+## Usage
+
+### Claude Desktop Integration
+
+Add the following to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ticktick": {
+      "command": "ticktick-mcp-server",
+      "env": {
+        "TICKTICK_ACCESS_TOKEN": "your_access_token_here"
+      }
+    }
+  }
+}
+```
+
+### Running Locally Without Installing the Gem
+
+If you prefer to run the server directly from the cloned repository:
+
+```json
+{
+  "mcpServers": {
+    "ticktick": {
+      "command": "bundle",
+      "args": ["exec", "exe/ticktick-mcp-server"],
+      "cwd": "/path/to/ticktick-mcp-server",
+      "env": {
+        "TICKTICK_ACCESS_TOKEN": "your_access_token_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Project Management
+
+| Tool | Description | Required Arguments |
+|---|---|---|
+| `list_projects` | List all projects | — |
+| `get_project` | Get a project by ID | `project_id` |
+| `get_project_data` | Get project details including tasks and columns | `project_id` |
+| `create_project` | Create a new project | `name` |
+| `update_project` | Update an existing project | `project_id` |
+| `delete_project` | Delete a project | `project_id` |
+
+### Task Management
+
+| Tool | Description | Required Arguments |
+|---|---|---|
+| `list_all_tasks` | List all tasks across all projects | — |
+| `create_task` | Create a new task | `title`, `project_id` |
+| `update_task` | Update an existing task | `task_id`, `project_id` |
+| `complete_task` | Mark a task as complete | `project_id`, `task_id` |
+| `delete_task` | Delete a task | `project_id`, `task_id` |
+
+## Development
+
+```bash
+bundle exec rake          # Run tests + RuboCop
+bundle exec rspec         # Run tests only
+bundle exec rubocop       # Run linter only
+```
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]

data/exe/ticktick-mcp-server

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "ticktick/mcp/server"
+
+server = Ticktick::Mcp::Server.build
+transport = MCP::Server::Transports::StdioTransport.new(server)
+transport.open

data/lib/ticktick/client.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative "errors"
+require_relative "http_connection"
+require_relative "resources/project_resource"
+require_relative "resources/task_resource"
+require_relative "resources/task_attributes"
+
+module Ticktick
+  class Client
+    def initialize(token: ENV["TICKTICK_ACCESS_TOKEN"])
+      @connection = HttpConnection.new(token: token)
+      @projects   = Resources::ProjectResource.new(@connection)
+      @tasks      = Resources::TaskResource.new(@connection, @projects)
+    end
+
+    def list_projects = @projects.list
+    def get_project(id) = @projects.get(id)
+    def get_project_data(id) = @projects.get_data(id)
+    def create_project(...) = @projects.create(...)
+    def update_project(id, ...) = @projects.update(id, ...)
+    def list_all_tasks = @tasks.list_all
+
+    def create_task(title:, project_id:, **opts)
+      @tasks.create(Resources::TaskAttributes.new(title: title, project_id: project_id, **opts))
+    end
+
+    def update_task(task_id:, project_id:, **opts)
+      @tasks.update(task_id, Resources::TaskAttributes.new(id: task_id, project_id: project_id, **opts))
+    end
+
+    def complete_task(project_id:, task_id:)
+      @tasks.complete(project_id, task_id)
+    end
+
+    def delete_project(project_id:) = @projects.delete(project_id)
+
+    def delete_task(project_id:, task_id:)
+      @tasks.delete(project_id, task_id)
+    end
+  end
+end

data/lib/ticktick/errors.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Ticktick
+  module Errors
+    class Error < StandardError; end
+
+    class AuthenticationError < Error; end
+
+    class ApiError < Error
+      attr_reader :status, :body
+
+      def initialize(status:, body:)
+        @status = status
+        @body = body
+        super("HTTP #{status}: #{body}")
+      end
+    end
+
+    class RateLimitError < ApiError; end
+  end
+end

data/lib/ticktick/http_connection.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "json"
+require_relative "errors"
+
+module Ticktick
+  class HttpConnection
+    API_BASE = "https://api.ticktick.com/open/v1"
+    RATE_LIMIT_ERROR_CODE = "exceed_query_limit"
+
+    def initialize(token:)
+      raise Errors::AuthenticationError, "Environment variable TICKTICK_ACCESS_TOKEN is not set" unless token
+
+      @conn = Faraday.new(url: API_BASE) do |f|
+        f.request :authorization, "Bearer", token
+      end
+    end
+
+    def get(path)
+      handle_response(@conn.get(path))
+    end
+
+    def post(path)
+      handle_response(@conn.post(path))
+    end
+
+    def delete(path)
+      handle_response(@conn.delete(path))
+    end
+
+    def post_json(path, body)
+      response = @conn.post(path) do |req|
+        req.headers["Content-Type"] = "application/json"
+        req.body = body.to_json
+      end
+      handle_response(response)
+    end
+
+    private
+
+    def handle_response(response)
+      unless response.success?
+        raise_rate_limit_error!(response) if rate_limit_error?(response)
+        raise Errors::ApiError.new(status: response.status, body: response.body)
+      end
+
+      return nil if response.body.nil? || response.body.empty?
+
+      JSON.parse(response.body)
+    end
+
+    def rate_limit_error?(response)
+      parsed = JSON.parse(response.body)
+      parsed["errorCode"] == RATE_LIMIT_ERROR_CODE
+    rescue JSON::ParserError
+      false
+    end
+
+    def raise_rate_limit_error!(response)
+      raise Errors::RateLimitError.new(status: response.status, body: response.body)
+    end
+  end
+end

data/lib/ticktick/mcp/server/error_handler.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Ticktick
+  module Mcp
+    module Server
+      module ErrorHandler
+        RATE_LIMIT_MESSAGE = "TickTick API rate limit reached (max 100 requests/min). Please retry after 1 minute."
+
+        def error_response(text)
+          MCP::Tool::Response.new([{ type: "text", text: text }], error: true)
+        end
+
+        def handle_client_error(error)
+          case error
+          when Ticktick::Errors::AuthenticationError
+            error_response(error.message)
+          when Ticktick::Errors::RateLimitError
+            error_response(RATE_LIMIT_MESSAGE)
+          when Ticktick::Errors::ApiError
+            error_response("API error (HTTP #{error.status}): #{error.body}")
+          else
+            error_response("API request error: #{error.message}")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/project/create_project.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class CreateProject < MCP::Tool
+        tool_name "create_project"
+
+        description "Create a new TickTick project"
+
+        input_schema(
+          properties: {
+            name: {
+              type: "string",
+              description: "Name of the project (required)"
+            },
+            color: {
+              type: "string",
+              description: 'Color of the project, e.g. "#F18181"'
+            },
+            sort_order: {
+              type: "integer",
+              description: "Sort order value of the project"
+            },
+            view_mode: {
+              type: "string",
+              description: 'View mode: "list", "kanban", or "timeline"'
+            },
+            kind: {
+              type: "string",
+              description: 'Project kind: "TASK" or "NOTE"'
+            }
+          },
+          required: ["name"]
+        )
+
+        class << self
+          include ErrorHandler
+
+          def call(name:, color: nil, sort_order: nil, view_mode: nil, kind: nil, _server_context: nil, **)
+            project = Ticktick::Client.new.create_project(
+              name: name,
+              color: color,
+              sort_order: sort_order,
+              view_mode: view_mode,
+              kind: kind
+            )
+            MCP::Tool::Response.new([{ type: "text", text: JSON.pretty_generate(project) }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/project/delete_project.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class DeleteProject < MCP::Tool
+        tool_name "delete_project"
+
+        description "Delete a project in TickTick"
+
+        input_schema(
+          properties: {
+            project_id: { type: "string", description: "The ID of the project to delete (required)" }
+          },
+          required: %w[project_id]
+        )
+
+        class << self
+          include ErrorHandler
+
+          def call(project_id:, _server_context: nil, **)
+            Ticktick::Client.new.delete_project(project_id: project_id)
+            MCP::Tool::Response.new([{ type: "text", text: "Project #{project_id} deleted." }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/project/get_project.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class GetProject < MCP::Tool
+        tool_name "get_project"
+
+        description "Get a project by ID from TickTick"
+
+        input_schema(
+          properties: {
+            project_id: {
+              type: "string",
+              description: "The ID of the project to retrieve"
+            }
+          },
+          required: ["project_id"]
+        )
+
+        class << self
+          include ErrorHandler
+
+          def call(project_id:, _server_context: nil)
+            data = Ticktick::Client.new.get_project(project_id)
+            MCP::Tool::Response.new([{ type: "text", text: JSON.pretty_generate(data) }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/project/get_project_data.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class GetProjectData < MCP::Tool
+        tool_name "get_project_data"
+
+        description "Get project data including tasks and columns from TickTick"
+
+        input_schema(
+          properties: {
+            project_id: {
+              type: "string",
+              description: "The ID of the project to retrieve data for"
+            }
+          },
+          required: ["project_id"]
+        )
+
+        class << self
+          include ErrorHandler
+
+          def call(project_id:, _server_context: nil)
+            data = Ticktick::Client.new.get_project_data(project_id)
+            MCP::Tool::Response.new([{ type: "text", text: JSON.pretty_generate(data) }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/project/list_projects.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class ListProjects < MCP::Tool
+        tool_name "list_projects"
+
+        description "List all projects from TickTick"
+
+        input_schema(properties: {})
+
+        class << self
+          include ErrorHandler
+
+          def call(_server_context: nil)
+            data = Ticktick::Client.new.list_projects
+            MCP::Tool::Response.new([{ type: "text", text: JSON.pretty_generate(data) }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/project/update_project.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class UpdateProject < MCP::Tool
+        tool_name "update_project"
+
+        description "Update an existing TickTick project's metadata"
+
+        input_schema(
+          properties: {
+            project_id: {
+              type: "string",
+              description: "The ID of the project to update"
+            },
+            name: {
+              type: "string",
+              description: "New name of the project"
+            },
+            color: {
+              type: "string",
+              description: 'New color of the project, e.g. "#F18181"'
+            },
+            sort_order: {
+              type: "integer",
+              description: "Sort order value of the project"
+            },
+            view_mode: {
+              type: "string",
+              description: 'View mode: "list", "kanban", or "timeline"'
+            },
+            kind: {
+              type: "string",
+              description: 'Project kind: "TASK" or "NOTE"'
+            }
+          },
+          required: ["project_id"]
+        )
+
+        class << self
+          include ErrorHandler
+
+          def call(project_id:, name: nil, color: nil, sort_order: nil,
+                   view_mode: nil, kind: nil, _server_context: nil, **)
+            client = Ticktick::Client.new
+            project = client.update_project(
+              project_id,
+              name: name, color: color,
+              sort_order: sort_order, view_mode: view_mode, kind: kind
+            )
+            MCP::Tool::Response.new([{ type: "text", text: JSON.pretty_generate(project) }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/task/complete_task.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class CompleteTask < MCP::Tool
+        tool_name "complete_task"
+
+        description "Mark a task as complete in TickTick"
+
+        input_schema(
+          properties: {
+            project_id: { type: "string", description: "Project ID the task belongs to (required)" },
+            task_id: { type: "string", description: "Task ID to complete (required)" }
+          },
+          required: %w[project_id task_id]
+        )
+
+        class << self
+          include ErrorHandler
+
+          def call(project_id:, task_id:, _server_context: nil, **)
+            Ticktick::Client.new.complete_task(project_id: project_id, task_id: task_id)
+            MCP::Tool::Response.new([{ type: "text", text: "Task #{task_id} marked as complete." }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/task/create_task.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class CreateTask < MCP::Tool
+        tool_name "create_task"
+
+        description "Create a new task in TickTick"
+
+        input_schema(
+          properties: {
+            title: { type: "string", description: "Task title (required)" },
+            project_id: { type: "string", description: "Project ID to add the task to (required)" },
+            content: { type: "string", description: "Task content" },
+            desc: { type: "string", description: "Description of checklist" },
+            is_all_day: { type: "boolean", description: "All day task" },
+            start_date: {
+              type: "string",
+              description: 'Start date in "yyyy-MM-dd\'T\'HH:mm:ssZ" format, e.g. "2019-11-13T03:00:00+0000"'
+            },
+            due_date: {
+              type: "string",
+              description: 'Due date in "yyyy-MM-dd\'T\'HH:mm:ssZ" format, e.g. "2019-11-13T03:00:00+0000"'
+            },
+            time_zone: { type: "string", description: 'Time zone, e.g. "America/Los_Angeles"' },
+            reminders: {
+              type: "array",
+              items: { type: "string" },
+              description: 'List of reminders, e.g. ["TRIGGER:P0DT9H0M0S"]'
+            },
+            repeat_flag: {
+              type: "string",
+              description: 'Recurring rule, e.g. "RRULE:FREQ=DAILY;INTERVAL=1"'
+            },
+            priority: {
+              type: "integer",
+              description: "Priority (0: none, 1: low, 3: medium, 5: high)"
+            },
+            sort_order: { type: "integer", description: "Sort order of the task" },
+            items: {
+              type: "array",
+              description: "List of subtasks",
+              items: {
+                type: "object",
+                properties: {
+                  title: { type: "string" },
+                  start_date: { type: "string" },
+                  is_all_day: { type: "boolean" },
+                  sort_order: { type: "integer" },
+                  time_zone: { type: "string" },
+                  status: { type: "integer" }
+                }
+              }
+            }
+          },
+          required: %w[title project_id]
+        )
+
+        class << self
+          include ErrorHandler
+
+          def call(title:, project_id:, content: nil, desc: nil,
+                   is_all_day: nil, start_date: nil, due_date: nil,
+                   time_zone: nil, reminders: nil, repeat_flag: nil,
+                   priority: nil, sort_order: nil, items: nil,
+                   _server_context: nil, **)
+            task = Ticktick::Client.new.create_task(
+              title: title, project_id: project_id, content: content, desc: desc,
+              is_all_day: is_all_day, start_date: start_date, due_date: due_date,
+              time_zone: time_zone, reminders: reminders, repeat_flag: repeat_flag,
+              priority: priority, sort_order: sort_order, items: items
+            )
+            MCP::Tool::Response.new([{ type: "text", text: JSON.pretty_generate(task) }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/task/delete_task.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class DeleteTask < MCP::Tool
+        tool_name "delete_task"
+
+        description "Delete a task in TickTick"
+
+        input_schema(
+          properties: {
+            project_id: { type: "string", description: "Project ID the task belongs to (required)" },
+            task_id: { type: "string", description: "Task ID to delete (required)" }
+          },
+          required: %w[project_id task_id]
+        )
+
+        class << self
+          include ErrorHandler
+
+          def call(project_id:, task_id:, _server_context: nil, **)
+            Ticktick::Client.new.delete_task(project_id: project_id, task_id: task_id)
+            MCP::Tool::Response.new([{ type: "text", text: "Task #{task_id} deleted." }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/task/list_all_tasks.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class ListAllTasks < MCP::Tool
+        tool_name "list_all_tasks"
+
+        description "List all tasks across all projects from TickTick"
+
+        input_schema(properties: {})
+
+        class << self
+          include ErrorHandler
+
+          def call(_server_context: nil)
+            tasks = Ticktick::Client.new.list_all_tasks
+            MCP::Tool::Response.new([{ type: "text", text: JSON.pretty_generate(tasks) }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/tools/task/update_task.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../error_handler"
+
+module Ticktick
+  module Mcp
+    module Server
+      class UpdateTask < MCP::Tool
+        tool_name "update_task"
+
+        description "Update an existing task in TickTick"
+
+        input_schema(
+          properties: {
+            task_id: { type: "string", description: "Task ID to update (required)" },
+            project_id: { type: "string", description: "Project ID the task belongs to (required)" },
+            title: { type: "string", description: "Task title" },
+            content: { type: "string", description: "Task content" },
+            desc: { type: "string", description: "Description of checklist" },
+            is_all_day: { type: "boolean", description: "All day task" },
+            start_date: {
+              type: "string",
+              description: 'Start date in "yyyy-MM-dd\'T\'HH:mm:ssZ" format, e.g. "2019-11-13T03:00:00+0000"'
+            },
+            due_date: {
+              type: "string",
+              description: 'Due date in "yyyy-MM-dd\'T\'HH:mm:ssZ" format, e.g. "2019-11-13T03:00:00+0000"'
+            },
+            time_zone: { type: "string", description: 'Time zone, e.g. "America/Los_Angeles"' },
+            reminders: {
+              type: "array",
+              items: { type: "string" },
+              description: 'List of reminders, e.g. ["TRIGGER:P0DT9H0M0S"]'
+            },
+            repeat_flag: {
+              type: "string",
+              description: 'Recurring rule, e.g. "RRULE:FREQ=DAILY;INTERVAL=1"'
+            },
+            priority: {
+              type: "integer",
+              description: "Priority (0: none, 1: low, 3: medium, 5: high)"
+            },
+            sort_order: { type: "integer", description: "Sort order of the task" },
+            items: {
+              type: "array",
+              description: "List of subtasks",
+              items: {
+                type: "object",
+                properties: {
+                  title: { type: "string" },
+                  start_date: { type: "string" },
+                  is_all_day: { type: "boolean" },
+                  sort_order: { type: "integer" },
+                  time_zone: { type: "string" },
+                  status: { type: "integer" }
+                }
+              }
+            }
+          },
+          required: %w[task_id project_id]
+        )
+
+        class << self
+          include ErrorHandler
+
+          # rubocop:disable Metrics/ParameterLists
+          def call(task_id:, project_id:, title: nil, content: nil, desc: nil,
+                   is_all_day: nil, start_date: nil, due_date: nil,
+                   time_zone: nil, reminders: nil, repeat_flag: nil,
+                   priority: nil, sort_order: nil, items: nil,
+                   _server_context: nil, **)
+            # rubocop:enable Metrics/ParameterLists
+            task = Ticktick::Client.new.update_task(
+              task_id: task_id, project_id: project_id, title: title, content: content, desc: desc,
+              is_all_day: is_all_day, start_date: start_date, due_date: due_date,
+              time_zone: time_zone, reminders: reminders, repeat_flag: repeat_flag,
+              priority: priority, sort_order: sort_order, items: items
+            )
+            MCP::Tool::Response.new([{ type: "text", text: JSON.pretty_generate(task) }])
+          rescue Ticktick::Errors::Error, StandardError => e
+            handle_client_error(e)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ticktick/mcp/server/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Ticktick
+  module Mcp
+    module Server
+      VERSION = "0.1.0"
+    end
+  end
+end

data/lib/ticktick/mcp/server.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../../ticktick/client"
+require_relative "server/version"
+require_relative "server/tools/project/list_projects"
+require_relative "server/tools/project/get_project"
+require_relative "server/tools/project/get_project_data"
+require_relative "server/tools/task/list_all_tasks"
+require_relative "server/tools/task/create_task"
+require_relative "server/tools/task/update_task"
+require_relative "server/tools/task/complete_task"
+require_relative "server/tools/task/delete_task"
+require_relative "server/tools/project/create_project"
+require_relative "server/tools/project/update_project"
+require_relative "server/tools/project/delete_project"
+
+module Ticktick
+  module Mcp
+    module Server
+      class Error < StandardError; end
+
+      def self.build
+        MCP::Server.new(
+          name: "ticktick-mcp-server",
+          version: VERSION,
+          tools: [ListProjects, GetProject, GetProjectData, ListAllTasks,
+                  CreateTask, UpdateTask, CompleteTask, DeleteTask, CreateProject, UpdateProject, DeleteProject]
+        )
+      end
+    end
+  end
+end

data/lib/ticktick/resources/project_resource.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Ticktick
+  module Resources
+    class ProjectResource
+      def initialize(connection)
+        @connection = connection
+      end
+
+      def list
+        @connection.get("project")
+      end
+
+      def get(project_id)
+        @connection.get("project/#{project_id}")
+      end
+
+      def get_data(project_id)
+        @connection.get("project/#{project_id}/data")
+      end
+
+      def create(name:, color: nil, sort_order: nil, view_mode: nil, kind: nil)
+        body = { name: name }
+        body[:color] = color if color
+        body[:sortOrder] = sort_order if sort_order
+        body[:viewMode] = view_mode if view_mode
+        body[:kind] = kind if kind
+        @connection.post_json("project", body)
+      end
+
+      def update(project_id, name: nil, color: nil, sort_order: nil, view_mode: nil, kind: nil)
+        body = { name: name, color: color, sortOrder: sort_order, viewMode: view_mode, kind: kind }.compact
+        @connection.post_json("project/#{project_id}", body)
+      end
+
+      def delete(project_id)
+        @connection.delete("project/#{project_id}")
+      end
+    end
+  end
+end

data/lib/ticktick/resources/task_attributes.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Ticktick
+  module Resources
+    class TaskAttributes
+      # rubocop:disable Metrics/MethodLength
+      def initialize(title:, project_id:, id: nil, content: nil, desc: nil,
+                     is_all_day: nil, start_date: nil, due_date: nil,
+                     time_zone: nil, reminders: nil, repeat_flag: nil,
+                     priority: nil, sort_order: nil, items: nil)
+        @id = id
+        @title = title
+        @project_id = project_id
+        @content = content
+        @desc = desc
+        @is_all_day = is_all_day
+        @start_date = start_date
+        @due_date = due_date
+        @time_zone = time_zone
+        @reminders = reminders
+        @repeat_flag = repeat_flag
+        @priority = priority
+        @sort_order = sort_order
+        @items = items
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def to_request_body
+        {
+          id: @id, title: @title, projectId: @project_id, content: @content,
+          desc: @desc, isAllDay: @is_all_day, startDate: @start_date,
+          dueDate: @due_date, timeZone: @time_zone, reminders: @reminders,
+          repeatFlag: @repeat_flag, priority: @priority,
+          sortOrder: @sort_order, items: @items
+        }.compact
+      end
+    end
+  end
+end

data/lib/ticktick/resources/task_resource.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require_relative "../errors"
+
+module Ticktick
+  module Resources
+    class TaskResource
+      def initialize(connection, project_resource)
+        @connection = connection
+        @projects = project_resource
+      end
+
+      def create(task_attrs)
+        @connection.post_json("task", task_attrs.to_request_body)
+      end
+
+      def update(task_id, task_attrs)
+        @connection.post_json("task/#{task_id}", task_attrs.to_request_body)
+      end
+
+      def complete(project_id, task_id)
+        @connection.post("project/#{project_id}/task/#{task_id}/complete")
+      end
+
+      def delete(project_id, task_id)
+        @connection.delete("project/#{project_id}/task/#{task_id}")
+      end
+
+      def list_all
+        @projects.list.each_with_object([]) do |project, all_tasks|
+          collect_project_tasks(project, all_tasks)
+        rescue Errors::ApiError
+          next
+        end
+      end
+
+      private
+
+      def collect_project_tasks(project, all_tasks)
+        data = @projects.get_data(project["id"])
+        (data["tasks"] || []).each do |task|
+          task["project_name"] = project["name"]
+          all_tasks << task
+        end
+      end
+    end
+  end
+end

data/mise.toml

@@ -0,0 +1,2 @@
+[tools]
+ruby = "4.0.1"

data/sig/ticktick/mcp/server.rbs

@@ -0,0 +1,8 @@
+module Ticktick
+  module Mcp
+    module Server
+      VERSION: String
+      # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+    end
+  end
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: ticktick-mcp-server
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- j-o-lantern0422
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A Model Context Protocol (MCP) server that provides tools to interact
+  with the TickTick API
+email:
+- j.o.lantern0422@gmail.com
+executables:
+- ticktick-mcp-server
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- ".rubocop.yml"
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/ticktick-mcp-server
+- lib/ticktick/client.rb
+- lib/ticktick/errors.rb
+- lib/ticktick/http_connection.rb
+- lib/ticktick/mcp/server.rb
+- lib/ticktick/mcp/server/error_handler.rb
+- lib/ticktick/mcp/server/tools/project/create_project.rb
+- lib/ticktick/mcp/server/tools/project/delete_project.rb
+- lib/ticktick/mcp/server/tools/project/get_project.rb
+- lib/ticktick/mcp/server/tools/project/get_project_data.rb
+- lib/ticktick/mcp/server/tools/project/list_projects.rb
+- lib/ticktick/mcp/server/tools/project/update_project.rb
+- lib/ticktick/mcp/server/tools/task/complete_task.rb
+- lib/ticktick/mcp/server/tools/task/create_task.rb
+- lib/ticktick/mcp/server/tools/task/delete_task.rb
+- lib/ticktick/mcp/server/tools/task/list_all_tasks.rb
+- lib/ticktick/mcp/server/tools/task/update_task.rb
+- lib/ticktick/mcp/server/version.rb
+- lib/ticktick/resources/project_resource.rb
+- lib/ticktick/resources/task_attributes.rb
+- lib/ticktick/resources/task_resource.rb
+- mise.toml
+- sig/ticktick/mcp/server.rbs
+homepage: https://github.com/j-o-lantern0422/ticktick-mcp-server
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/j-o-lantern0422/ticktick-mcp-server
+  source_code_uri: https://github.com/j-o-lantern0422/ticktick-mcp-server
+  changelog_uri: https://github.com/j-o-lantern0422/ticktick-mcp-server/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: MCP server for TickTick task management
+test_files: []