MCP Server MCP

io.github.partymola/ticktick-mcp

By github 👁 1 views ▲ 0 votes

MCP server for TickTick task management: field-preserving updates and completion tracking.

Homepage Verified source GitHub

Install

oci:ghcr.io/partymola/ticktick-mcp:v0.3.3

Configuration Example

{
  "remotes": [],
  "packages": [
    {
      "registryType": "oci",
      "identifier": "ghcr.io/partymola/ticktick-mcp:v0.3.3",
      "runtimeHint": "docker",
      "transport": {
        "type": "stdio"
      },
      "runtimeArguments": [
        {
          "isRequired": true,
          "value": "{uid_gid}",
          "variables": {
            "uid_gid": {
              "description": "Your own user and group id, as `uid:gid` (run `id -u`:`id -g`). The container runs as root otherwise, and anything it writes into the mounted directory becomes root-owned - after which a host-side `ticktick-mcp` can no longer update its session-token cache and falls back to a signon TickTick throttles.",
              "isRequired": true,
              "placeholder": "1000:1000"
            }
          },
          "type": "named",
          "name": "--user"
        },
        {
          "isRequired": true,
          "value": "{data_volume}:/data",
          "variables": {
            "data_volume": {
              "description": "Absolute path to the host directory of an ALREADY AUTHORISED setup - it must already hold the cached OAuth token written by running `ticktick-mcp auth` in a terminal. Not an empty volume and not a relative path: the OAuth step cannot run inside the container, and a container without a cached token reads standard input, which is the JSON-RPC channel. Also holds the .env, the v2 session token and the completion-tracking database.",
              "isRequired": true,
              "format": "filepath",
              "placeholder": "/home/you/.config/ticktick-mcp"
            }
          },
          "type": "named",
          "name": "-v"
        }
      ],
      "environmentVariables": [
        {
          "description": "TickTick OAuth client ID. Needed only if you are not mounting a .env file.",
          "name": "TICKTICK_CLIENT_ID"
        },
        {
          "description": "TickTick OAuth client secret. Needed only if you are not mounting a .env file.",
          "isSecret": true,
          "name": "TICKTICK_CLIENT_SECRET"
        },
        {
          "description": "TickTick account username. Needed only if you are not mounting a .env file.",
          "name": "TICKTICK_USERNAME"
        },
        {
          "description": "TickTick account password. Needed only if you are not mounting a .env file.",
          "isSecret": true,
          "name": "TICKTICK_PASSWORD"
        }
      ]
    }
  ]
}

mcp model-context-protocol oci