{"id":"jen6-ticktick-mcp","name":"ticktick-mcp","homepage":null,"repo_url":"https://github.com/jen6/ticktick-mcp","category":"automation","subcategories":[],"tags":["mcp","ticktick","task-management","productivity","python","oauth2","agent-integration"],"what_it_does":"Provides an MCP server that connects to the (unofficial) TickTick API via the ticktick-py library, exposing tools for task and subtask management plus task/project/tag retrieval and datetime conversion helpers.","use_cases":["AI assistants that plan work from your TickTick tasks","Automating task creation/update/completion via an MCP client","Filtering tasks by priority, project, tags, and due/completion date windows","Building workflows in MCP-compatible clients (e.g., Claude Desktop, VS Code Agent Mode)"],"not_for":["High-volume batch operations where strong rate-limit/idempotency guarantees are required","Environments where storing/handling TickTick credentials and OAuth tokens is disallowed","Users needing a fully official/contracted integration rather than an unofficial wrapper"],"best_when":"You want an agent to read and modify a personal TickTick workspace through structured MCP tools, with local credential handling.","avoid_when":"You cannot or do not want to run a local MCP server that performs OAuth/token caching and makes authenticated requests to TickTick.","alternatives":["Use ticktick-py directly from your own app","Build a small wrapper service with a documented REST API around TickTick (instead of MCP)","Use another existing MCP server for task/work management if it supports your preferred platforms"],"af_score":50.5,"security_score":54.2,"reliability_score":15.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:54:18.131023+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["OAuth2 (TickTick app credentials)","Username/password for TickTick login (via ticktick-py underlying flow)"],"oauth":true,"scopes":false,"notes":"README indicates OAuth2 authorization with Read and Write permissions and token caching to a local .token-oauth file. No explicit mention of fine-grained scopes in this repo README."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing described; appears to be a self-hosted open-source tool (license: MIT badge in README)."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":50.5,"security_score":54.2,"reliability_score":15.0,"mcp_server_quality":75.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":45.0,"rate_limit_clarity":10.0,"tls_enforcement":60.0,"auth_strength":70.0,"scope_granularity":40.0,"dependency_hygiene":45.0,"secret_handling":50.0,"security_notes":"Uses OAuth2 and stores tokens locally in a .token-oauth file alongside a user-created .env. README instructs users to store TickTick username/password (or app password) and client secret in a plaintext .env, which can be risky if local filesystem permissions/logging are misconfigured. Rate limits, error codes, and secret-handling practices are not documented in the README; TLS enforcement and logging behavior are not explicitly stated in provided content.","uptime_documented":0.0,"version_stability":30.0,"breaking_changes_history":10.0,"error_recovery":20.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Operations like create/update/delete may not be idempotent; agents should avoid naive retries without confirming outcomes.","First-run OAuth flow requires a manual redirect URL paste into the terminal; non-interactive MCP client setups may struggle.","Datetime handling relies on ISO 8601 and timezone parameters; agents may produce invalid formats unless they use the provided conversion tool."]}}