tick-mcp 0.1.0__tar.gz

tick_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,237 @@
+Metadata-Version: 2.3
+Name: tick-mcp
+Version: 0.1.0
+Summary: MCP server for TickTick — task and notes access via Model Context Protocol.
+Keywords: ticktick,mcp,model-context-protocol,tasks,productivity
+Author: Ivann KAMDEM
+Author-email: Ivann KAMDEM <kapoivha@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Scheduling
+Requires-Dist: mcp>=1.26.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: typer>=0.12.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/kpihx/tick-mcp
+Project-URL: Repository, https://github.com/kpihx/tick-mcp
+Project-URL: Issues, https://github.com/kpihx/tick-mcp/issues
+Project-URL: Changelog, https://github.com/kpihx/tick-mcp/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# tick-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/tick-mcp)](https://pypi.org/project/tick-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/tick-mcp)](https://pypi.org/project/tick-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**MCP server for TickTick** — manage tasks, projects, habits, tags, focus stats, and more through the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+**71 tools** exposed over MCP, covering both the official TickTick Open API (V1) and the unofficial web API (V2) for features not yet available publicly.
+
+---
+
+## Features
+
+| Category | Tools |
+|---|---|
+| **Tasks** | `create_task` · `update_task` · `complete_task` · `reopen_task` · `delete_task` · `get_task_detail` · `get_project_tasks` · `get_inbox` · `get_all_tasks` |
+| **Batch** | `batch_create_tasks` · `batch_update_tasks` · `batch_delete_tasks` · `move_tasks` |
+| **Projects** | `create_project` · `update_project` · `delete_project` · `get_project_detail` · `list_projects` |
+| **Query / Search** | `workspace_map` · `query_projects` · `query_folders` · `query_tasks` · `query_notes` · `query_agenda` · `query_task_history` · `list_query_presets` · `save_query_preset` · `run_query_preset` · `delete_query_preset` |
+| **Views** | `tasks_of_today` · `events_of_today` · `week_agenda` · `week_overview` · `upcoming_tasks` · `overdue_tasks` · `stale_tasks` · `priority_dashboard` |
+| **Verified Actions** | `create_subtask` · `verified_create_project` · `verified_set_subtask_parent` · `verified_move_tasks` · `verified_batch_move` · `verified_assign_project_folder` |
+| **Tags** | `create_tag` · `update_tag` · `rename_tag` · `merge_tags` · `delete_tag` · `list_tags` |
+| **Habits** | `create_habit` · `update_habit` · `delete_habit` · `list_habits` · `habit_checkin` · `get_habit_records` · `list_habit_sections` |
+| **Kanban** | `list_columns` · `manage_columns` |
+| **Folders** | `list_project_folders` · `manage_project_folders` |
+| **Focus** | `get_focus_stats` |
+| **History** | `get_completed_tasks` · `get_deleted_tasks` |
+| **Subtasks** | `set_subtask_parent` |
+| **Sync / Stats** | `full_sync` · `get_user_status` · `get_productivity_stats` |
+| **Utilities** | `ticktick_guide` · `check_v2_availability` · `build_recurrence_rule` · `build_reminder` |
+
+### Query / Search highlights
+
+- **Structured task filtering** — folders, projects, tags, parent/subtask shape, reminders, recurrence, checklist presence, and priorities.
+- **Time-aware agenda access** — query by date range, datetime range, and HH:MM time windows without forcing a full sync first.
+- **Grep-like matching** — substring search, `any` / `all` / `phrase` keyword modes, regex, and exclusion regex across chosen fields.
+- **Targeted note search** — notes are fetched only from NOTE projects in scope instead of materializing the whole workspace.
+- **Workspace navigation** — folder/project map with optional active task counts to inspect the account structure before acting.
+- **Ready-made operational views** — day view, week window, upcoming due tasks, overdue/stale detection, and priority summaries built on the same filter engine.
+- **Saved query presets** — persist reusable task/note/agenda/history/week-overview queries and execute them later without rebuilding the filter set.
+
+### Verified workflow helpers
+
+- **Subtask-safe creation** — `create_subtask` creates the child, links it, then verifies `parentId` and `childIds`.
+- **Move verification** — `verified_move_tasks` re-reads destination projects and confirms every moved task is actually there.
+- **Folder assignment verification** — `verified_assign_project_folder` verifies the persisted `groupId` through V2 sync, not through the misleading V1 response.
+
+### Intent-first discovery
+
+`ticktick_guide()` supports both technical categories and real user goals.
+
+- Category-oriented:
+  - `ticktick_guide(category="tasks")`
+- Intent-oriented:
+  - `ticktick_guide(intent="know_what_to_do_today")`
+  - `ticktick_guide(intent="plan_the_week")`
+  - `ticktick_guide(intent="find_a_note")`
+  - `ticktick_guide(intent="reorganize_projects")`
+  - `ticktick_guide(intent="clean_up_tasks")`
+
+## Package Layout
+
+```text
+src/tick_mcp/
+├── mcp_api/
+│   ├── core.py          # shared FastMCP instance, catalog, helpers
+│   ├── utilities.py     # discovery + helper tools
+│   ├── projects.py      # project CRUD tools
+│   ├── tasks_read.py    # inbox / project / task reads
+│   ├── tasks_write.py   # task mutation tools
+│   ├── tasks_batch.py   # batch + structural task operations
+│   ├── read.py          # high-level query/search, views, and saved presets
+│   ├── verified.py      # safe wrappers with read-back verification + rollback hints
+│   ├── folders.py       # folders + kanban columns
+│   ├── tags.py          # tag tools
+│   ├── habits.py        # habit tools
+│   ├── history.py       # completed / deleted history
+│   └── stats.py         # focus and user/productivity stats
+├── services/
+│   └── query.py         # reusable filtering, range and grep-like planning
+├── client_api/
+│   ├── transport.py     # auth, sessions, low-level V1/V2 HTTP helpers
+│   ├── projects.py      # projects, folders, columns, tags
+│   ├── tasks.py         # tasks, sync, batch, history
+│   ├── habits.py        # habits and check-ins
+│   └── stats.py         # focus and user/productivity stats
+├── client.py            # stable public facade over client_api/*
+├── models.py            # pydantic contracts
+├── server.py            # stable public import surface for the MCP server
+└── main.py              # CLI entrypoint
+```
+
+## Installation
+
+```bash
+# recommended — installs as a standalone tool
+uv tool install tick-mcp
+
+# or via pip
+pip install tick-mcp
+```
+
+This provides two commands:
+
+| Command | Description |
+|---|---|
+| `tick-mcp` | Start the MCP server (stdio transport) |
+| `tick-admin` | CLI helper — session refresh, diagnostics |
+
+## Configuration
+
+### 1. Environment variables
+
+Copy the example file and fill in your tokens:
+
+```bash
+cp src/tick_mcp/.env.example src/tick_mcp/.env
+```
+
+| Variable | Required | Description |
+|---|---|---|
+| `TICKTICK_API_TOKEN` | **Yes** | V1 Open API bearer token (PAT or OAuth2) |
+| `TICKTICK_SESSION_TOKEN` | No | V2 session cookie for extended features |
+
+**Getting a V1 token (simplest):**
+
+1. Open TickTick → Settings → Integrations → API
+2. Copy the displayed Personal Access Token
+
+**Getting a V2 session token:**
+
+1. Log in to [ticktick.com](https://ticktick.com) in your browser
+2. DevTools → Application → Cookies → copy the `t` cookie value
+
+Or use the CLI to auto-login:
+
+```bash
+tick-admin session refresh
+```
+
+### 2. Server config
+
+Runtime settings live in `src/tick_mcp/config.yaml` — API endpoints, timeouts, and user-agent are all externalised there.
+
+## MCP Client Integration
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `~/.config/Claude/claude_desktop_config.json` (Linux):
+
+```json
+{
+  "mcpServers": {
+    "ticktick": {
+      "command": "tick-mcp",
+      "env": {
+        "TICKTICK_API_TOKEN": "your-v1-token",
+        "TICKTICK_SESSION_TOKEN": "your-v2-token"
+      }
+    }
+  }
+}
+```
+
+### VS Code (GitHub Copilot)
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "ticktick": {
+      "command": "tick-mcp",
+      "env": {
+        "TICKTICK_API_TOKEN": "your-v1-token",
+        "TICKTICK_SESSION_TOKEN": "your-v2-token"
+      }
+    }
+  }
+}
+```
+
+### Other MCP clients
+
+Any client that supports the stdio transport can launch `tick-mcp` as a subprocess.
+
+## Development
+
+```bash
+# Clone & install dev deps
+git clone https://github.com/kpihx/tick-mcp.git
+cd tick-mcp
+uv sync --group dev
+
+# Unit tests (155 selected unit tests, no network)
+uv run pytest
+
+# Live tests against real TickTick API (requires tokens in .env)
+uv run pytest -m live
+```
+
+### Test suite
+
+- **155 selected unit tests** — pure logic, mocked HTTP, zero network
+- **12 live integration scripts** — 508 assertions against the real TickTick API
+
+## License
+
+[MIT](LICENSE) © 2025 Ivann KAMDEM

tick_mcp-0.1.0/README.md

@@ -0,0 +1,210 @@
+# tick-mcp
+
+[![PyPI](https://img.shields.io/pypi/v/tick-mcp)](https://pypi.org/project/tick-mcp/)
+[![Python](https://img.shields.io/pypi/pyversions/tick-mcp)](https://pypi.org/project/tick-mcp/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+**MCP server for TickTick** — manage tasks, projects, habits, tags, focus stats, and more through the [Model Context Protocol](https://modelcontextprotocol.io/).
+
+**71 tools** exposed over MCP, covering both the official TickTick Open API (V1) and the unofficial web API (V2) for features not yet available publicly.
+
+---
+
+## Features
+
+| Category | Tools |
+|---|---|
+| **Tasks** | `create_task` · `update_task` · `complete_task` · `reopen_task` · `delete_task` · `get_task_detail` · `get_project_tasks` · `get_inbox` · `get_all_tasks` |
+| **Batch** | `batch_create_tasks` · `batch_update_tasks` · `batch_delete_tasks` · `move_tasks` |
+| **Projects** | `create_project` · `update_project` · `delete_project` · `get_project_detail` · `list_projects` |
+| **Query / Search** | `workspace_map` · `query_projects` · `query_folders` · `query_tasks` · `query_notes` · `query_agenda` · `query_task_history` · `list_query_presets` · `save_query_preset` · `run_query_preset` · `delete_query_preset` |
+| **Views** | `tasks_of_today` · `events_of_today` · `week_agenda` · `week_overview` · `upcoming_tasks` · `overdue_tasks` · `stale_tasks` · `priority_dashboard` |
+| **Verified Actions** | `create_subtask` · `verified_create_project` · `verified_set_subtask_parent` · `verified_move_tasks` · `verified_batch_move` · `verified_assign_project_folder` |
+| **Tags** | `create_tag` · `update_tag` · `rename_tag` · `merge_tags` · `delete_tag` · `list_tags` |
+| **Habits** | `create_habit` · `update_habit` · `delete_habit` · `list_habits` · `habit_checkin` · `get_habit_records` · `list_habit_sections` |
+| **Kanban** | `list_columns` · `manage_columns` |
+| **Folders** | `list_project_folders` · `manage_project_folders` |
+| **Focus** | `get_focus_stats` |
+| **History** | `get_completed_tasks` · `get_deleted_tasks` |
+| **Subtasks** | `set_subtask_parent` |
+| **Sync / Stats** | `full_sync` · `get_user_status` · `get_productivity_stats` |
+| **Utilities** | `ticktick_guide` · `check_v2_availability` · `build_recurrence_rule` · `build_reminder` |
+
+### Query / Search highlights
+
+- **Structured task filtering** — folders, projects, tags, parent/subtask shape, reminders, recurrence, checklist presence, and priorities.
+- **Time-aware agenda access** — query by date range, datetime range, and HH:MM time windows without forcing a full sync first.
+- **Grep-like matching** — substring search, `any` / `all` / `phrase` keyword modes, regex, and exclusion regex across chosen fields.
+- **Targeted note search** — notes are fetched only from NOTE projects in scope instead of materializing the whole workspace.
+- **Workspace navigation** — folder/project map with optional active task counts to inspect the account structure before acting.
+- **Ready-made operational views** — day view, week window, upcoming due tasks, overdue/stale detection, and priority summaries built on the same filter engine.
+- **Saved query presets** — persist reusable task/note/agenda/history/week-overview queries and execute them later without rebuilding the filter set.
+
+### Verified workflow helpers
+
+- **Subtask-safe creation** — `create_subtask` creates the child, links it, then verifies `parentId` and `childIds`.
+- **Move verification** — `verified_move_tasks` re-reads destination projects and confirms every moved task is actually there.
+- **Folder assignment verification** — `verified_assign_project_folder` verifies the persisted `groupId` through V2 sync, not through the misleading V1 response.
+
+### Intent-first discovery
+
+`ticktick_guide()` supports both technical categories and real user goals.
+
+- Category-oriented:
+  - `ticktick_guide(category="tasks")`
+- Intent-oriented:
+  - `ticktick_guide(intent="know_what_to_do_today")`
+  - `ticktick_guide(intent="plan_the_week")`
+  - `ticktick_guide(intent="find_a_note")`
+  - `ticktick_guide(intent="reorganize_projects")`
+  - `ticktick_guide(intent="clean_up_tasks")`
+
+## Package Layout
+
+```text
+src/tick_mcp/
+├── mcp_api/
+│   ├── core.py          # shared FastMCP instance, catalog, helpers
+│   ├── utilities.py     # discovery + helper tools
+│   ├── projects.py      # project CRUD tools
+│   ├── tasks_read.py    # inbox / project / task reads
+│   ├── tasks_write.py   # task mutation tools
+│   ├── tasks_batch.py   # batch + structural task operations
+│   ├── read.py          # high-level query/search, views, and saved presets
+│   ├── verified.py      # safe wrappers with read-back verification + rollback hints
+│   ├── folders.py       # folders + kanban columns
+│   ├── tags.py          # tag tools
+│   ├── habits.py        # habit tools
+│   ├── history.py       # completed / deleted history
+│   └── stats.py         # focus and user/productivity stats
+├── services/
+│   └── query.py         # reusable filtering, range and grep-like planning
+├── client_api/
+│   ├── transport.py     # auth, sessions, low-level V1/V2 HTTP helpers
+│   ├── projects.py      # projects, folders, columns, tags
+│   ├── tasks.py         # tasks, sync, batch, history
+│   ├── habits.py        # habits and check-ins
+│   └── stats.py         # focus and user/productivity stats
+├── client.py            # stable public facade over client_api/*
+├── models.py            # pydantic contracts
+├── server.py            # stable public import surface for the MCP server
+└── main.py              # CLI entrypoint
+```
+
+## Installation
+
+```bash
+# recommended — installs as a standalone tool
+uv tool install tick-mcp
+
+# or via pip
+pip install tick-mcp
+```
+
+This provides two commands:
+
+| Command | Description |
+|---|---|
+| `tick-mcp` | Start the MCP server (stdio transport) |
+| `tick-admin` | CLI helper — session refresh, diagnostics |
+
+## Configuration
+
+### 1. Environment variables
+
+Copy the example file and fill in your tokens:
+
+```bash
+cp src/tick_mcp/.env.example src/tick_mcp/.env
+```
+
+| Variable | Required | Description |
+|---|---|---|
+| `TICKTICK_API_TOKEN` | **Yes** | V1 Open API bearer token (PAT or OAuth2) |
+| `TICKTICK_SESSION_TOKEN` | No | V2 session cookie for extended features |
+
+**Getting a V1 token (simplest):**
+
+1. Open TickTick → Settings → Integrations → API
+2. Copy the displayed Personal Access Token
+
+**Getting a V2 session token:**
+
+1. Log in to [ticktick.com](https://ticktick.com) in your browser
+2. DevTools → Application → Cookies → copy the `t` cookie value
+
+Or use the CLI to auto-login:
+
+```bash
+tick-admin session refresh
+```
+
+### 2. Server config
+
+Runtime settings live in `src/tick_mcp/config.yaml` — API endpoints, timeouts, and user-agent are all externalised there.
+
+## MCP Client Integration
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `~/.config/Claude/claude_desktop_config.json` (Linux):
+
+```json
+{
+  "mcpServers": {
+    "ticktick": {
+      "command": "tick-mcp",
+      "env": {
+        "TICKTICK_API_TOKEN": "your-v1-token",
+        "TICKTICK_SESSION_TOKEN": "your-v2-token"
+      }
+    }
+  }
+}
+```
+
+### VS Code (GitHub Copilot)
+
+Add to `.vscode/mcp.json`:
+
+```json
+{
+  "servers": {
+    "ticktick": {
+      "command": "tick-mcp",
+      "env": {
+        "TICKTICK_API_TOKEN": "your-v1-token",
+        "TICKTICK_SESSION_TOKEN": "your-v2-token"
+      }
+    }
+  }
+}
+```
+
+### Other MCP clients
+
+Any client that supports the stdio transport can launch `tick-mcp` as a subprocess.
+
+## Development
+
+```bash
+# Clone & install dev deps
+git clone https://github.com/kpihx/tick-mcp.git
+cd tick-mcp
+uv sync --group dev
+
+# Unit tests (155 selected unit tests, no network)
+uv run pytest
+
+# Live tests against real TickTick API (requires tokens in .env)
+uv run pytest -m live
+```
+
+### Test suite
+
+- **155 selected unit tests** — pure logic, mocked HTTP, zero network
+- **12 live integration scripts** — 508 assertions against the real TickTick API
+
+## License
+
+[MIT](LICENSE) © 2025 Ivann KAMDEM

tick_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[project]
+name = "tick-mcp"
+version = "0.1.0"
+description = "MCP server for TickTick — task and notes access via Model Context Protocol."
+readme = "README.md"
+authors = [
+    { name = "Ivann KAMDEM", email = "kapoivha@gmail.com" }
+]
+license = {text = "MIT"}
+keywords = ["ticktick", "mcp", "model-context-protocol", "tasks", "productivity"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Scheduling",
+]
+requires-python = ">=3.12"
+dependencies = [
+    "mcp>=1.26.0",
+    "httpx>=0.27.0",
+    "pyyaml>=6.0",
+    "rich>=13.0",
+    "typer>=0.12.0",
+    "pydantic>=2.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.scripts]
+tick-mcp = "tick_mcp:main"
+tick-admin = "tick_mcp.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/kpihx/tick-mcp"
+Repository = "https://github.com/kpihx/tick-mcp"
+Issues = "https://github.com/kpihx/tick-mcp/issues"
+Changelog = "https://github.com/kpihx/tick-mcp/blob/main/CHANGELOG.md"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-timeout>=2.2",
+    "respx>=0.22",          # httpx mock transport (non-intrusive)
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "unit: pure logic, no I/O, no network, no secrets (fast)",
+    "integration: needs bw-env on PATH and real secrets in vault",
+    "live: hits the real TickTick API (slow, rate-limited)",
+]
+# Default: run unit + integration.  Use `pytest -m live` for live tests.
+addopts = "-v --tb=short -m 'not live'"
+timeout = 30
+
+[build-system]
+requires = ["uv_build>=0.10.3,<0.11.0"]
+build-backend = "uv_build"

tick_mcp-0.1.0/src/tick_mcp/.env

@@ -0,0 +1 @@
+TICKTICK_SESSION_TOKEN=0CAB80045A64122B0ECB7493DFFD334BFA3469A7C7933C1A7529592831BA123E381794D9023A6741EA70BFB8A3850AD53F9BD3732B61AC70D57703CDB39A419D9A1D95346CE2334EE55972BE9A423E1ED285B290342C2919CA06CD165860442C0FA432A6D7B1B92022F3B04295855CD5711F9CAEDB907858368E60D28CADEC360FA432A6D7B1B92045E034618F9E671A14BAE6DD8FFB527E04CB8D883175EAC591241BF011C106237353686E6CEE8A83

tick_mcp-0.1.0/src/tick_mcp/.env.example

@@ -0,0 +1,59 @@
+# TickTick MCP — Environment Variables
+# Copy this file to .env (same directory) and fill in your tokens.
+# .env is gitignored and takes priority over system environment variables.
+#
+# Alternatively, export these variables in your shell profile:
+#   echo 'export TICKTICK_API_TOKEN="your_token"' >> ~/.bashrc   # or ~/.zshrc
+#   source ~/.bashrc
+
+# ──────────────────────────────────────────────────────────────────────
+# [REQUIRED] V1 — Official Open API (OAuth2 Bearer token)
+# Docs: https://developer.ticktick.com/docs#/openapi
+# ──────────────────────────────────────────────────────────────────────
+# There are 2 ways to get this token:
+#
+# ── Method A: Personal Access Token (PAT) — simplest, recommended ────
+#   Works directly from the TickTick app, no OAuth dance needed.
+#   1. Open TickTick → Settings → Integrations (or About) → API
+#   2. A token is displayed there — copy it directly.
+#   Note: full scope, no known expiration, ideal for personal use.
+#
+# ── Method B: OAuth2 Authorization Code Flow ─────────────────────────
+#   Use this if you registered an app on developer.ticktick.com
+#   and have a client_id + client_secret + redirect_uri.
+#   Step 1 — Open in browser (replace values):
+#     https://ticktick.com/oauth/authorize
+#       ?response_type=code
+#       &client_id=<YOUR_CLIENT_ID>
+#       &redirect_uri=http://localhost:8080
+#       &scope=tasks:read%20tasks:write
+#   Step 2 — Exchange the ?code= param for a token:
+#     curl -X POST https://ticktick.com/oauth/token \
+#       -u "<CLIENT_ID>:<CLIENT_SECRET>" \
+#       -d "grant_type=authorization_code" \
+#       -d "code=<CODE_FROM_STEP1>" \
+#       -d "redirect_uri=http://localhost:8080"
+#   Step 3 — Copy access_token from the JSON response.
+#   Note: expires periodically; refresh with grant_type=refresh_token.
+TICKTICK_API_TOKEN=
+
+# ──────────────────────────────────────────────────────────────────────
+# [OPTIONAL] V2 — Unofficial Web API
+# ──────────────────────────────────────────────────────────────────────────────
+# Unlocks: tags, habits, focus/pomodoro, folders, columns, batch ops,
+#          completed/deleted tasks, user stats, sync, and more.
+#
+# Two auth strategies — pick ONE (token takes priority if both are set):
+#
+# ── Strategy 1: Session token (manual, no expiry concern during session) ──────
+#   1. Log in to https://ticktick.com in your browser
+#   2. Open DevTools → Application → Cookies → ticktick.com
+#   3. Copy the value of the 't' cookie (~30 day validity)
+TICKTICK_SESSION_TOKEN=
+
+# ── Strategy 2: Auto-refresh via CLI ─────────────────────────────────────────
+#   When your session token expires, run:
+#     ticktick-admin session refresh
+#   The CLI will prompt for username + password interactively (never stored),
+#   call POST /api/v2/user/signon, and write the new token above automatically.
+#   Credentials are discarded immediately after the login call.

tick_mcp-0.1.0/src/tick_mcp/__init__.py

@@ -0,0 +1,3 @@
+def main() -> None:
+    from .main import main as _main
+    _main()