Tickmcp

FreeNot checked

A remote multi-user MCP server that enables task management with TickTick through tools like listing projects, creating and updating tasks, and checking auth st

by maheshrijal

GitHub Embed

About

A remote multi-user MCP server that enables task management with TickTick through tools like listing projects, creating and updating tasks, and checking auth status.

README

[!IMPORTANT] This project is archived and no longer maintained. TickTick now provides an official MCP integration, which should be used instead.

Remote multi-user TickTick MCP server on Cloudflare Workers.

Streamable HTTP transport · OAuth 2.1 · Structured output

Connect

MCP endpoint: https://tickmcp.mrjl.dev/mcp

# Claude Code
claude mcp add tickmcp --transport http https://tickmcp.mrjl.dev/mcp

# Codex
codex mcp add tickmcp --url https://tickmcp.mrjl.dev/mcp

Claude Desktop / Cursor

{
  "mcpServers": {
    "tickmcp": {
      "type": "streamableHttp",
      "url": "https://tickmcp.mrjl.dev/mcp"
    }
  }
}

ChatGPT — add as remote MCP server URL: https://tickmcp.mrjl.dev/mcp

Tools

Tool	Description
`ticktick_auth_status`	Check TickTick connection status
`ticktick_list_projects`	List all projects
`ticktick_get_project`	Get a project by ID
`ticktick_create_project`	Create a project (supports `viewMode`, `sortOrder`, `kind`)
`ticktick_update_project`	Update a project (supports `viewMode`, `sortOrder`, `kind`)
`ticktick_delete_project`	Permanently delete a project
`ticktick_get_project_data`	Get project + undone tasks + columns envelope
`ticktick_list_tasks`	List active tasks with filters (project, `status=0`, due date, range, priority, sort) and pagination
`ticktick_get_task`	Get a task by ID
`ticktick_create_task`	Create a task (supports `repeat`/`repeatFlag`, reminders, checklist items, timezone/all-day, task kind)
`ticktick_update_task`	Update a task (supports `repeat`/`repeatFlag`, reminders, checklist items, timezone/all-day, task kind)
`ticktick_patch_task_items`	Patch checklist items deterministically (`add`/`update`/`remove`/`toggle`)
`ticktick_complete_task`	Mark a task complete
`ticktick_delete_task`	Delete a task

Current Limitation

ticktick_list_tasks intentionally supports active tasks only. status=2 (completed listing) is explicitly unsupported and returns VALIDATION_ERROR.

Architecture

MCP Client ←(OAuth 2.1)→ tickmcp ←(OAuth 2.0)→ TickTick API

Runtime: Cloudflare Workers
Transport: Streamable HTTP (POST /mcp)
Auth: OAuth 2.1 with consent screen + PKCE, proxying to TickTick OAuth 2.0
Storage: D1 (users, audit events, OAuth state) + KV (tokens, idempotency)
Rate limiting: Per-user via Cloudflare Rate Limiting

License

MIT

from github.com/maheshrijal/tickmcp

Installing Tickmcp

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/maheshrijal/tickmcp

FAQ

Is Tickmcp MCP free?

Yes, Tickmcp MCP is free — one-click install via Unyly at no cost.

Does Tickmcp need an API key?

No, Tickmcp runs without API keys or environment variables.

Is Tickmcp hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Tickmcp in Claude Desktop, Claude Code or Cursor?

Open Tickmcp on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Notion

Read and write pages in your workspace

by Notion

Linear

Issues, cycles, triage — from Claude

by Linear

Pro

Google Drive

Search and read your Drive files

by Google

mindsdb/mindsdb

Connect and unify data across various platforms and databases with [MindsDB as a single MCP server](https://docs.mindsdb.com/mcp/overview).

by mindsdb

fulcradynamics/fulcra-context-mcp

MCP server for accessing personal health and biometric data including sleep stages, heart rate, HRV, glucose, workouts, calendar, and location via the Fulcra Li

by fulcradynamics

aymericzip/intlayer

A MCP Server that enhance your IDE with AI-powered assistance for Intlayer i18n / CMS tool: smart CLI access, access to the docs.

by aymericzip

rinadelph/Agent-MCP

A framework for creating multi-agent systems using MCP for coordinated AI collaboration, featuring task management, shared context, and RAG capabilities.

by rinadelph

WhenLabs-org/when

Developer toolkit: auto-detect stack for AI context files, catch port conflicts, validate .env schemas, spot docs drift, audit dependency licenses, and time cod

by WhenLabs-org

Beltran12138/wecom-docs-mcp-server

WeCom (Enterprise WeChat) document operations via MCP: create, read, and edit Docs and Smartsheets (9 tools). Fills the doc-CRUD gap — existing WeCom MCP server

by Beltran12138

madbonez/caldav-mcp

Universal MCP server for CalDAV protocol integration. Works with any CalDAV-compatible calendar server including Yandex Calendar, Google Calendar (via CalDAV),

by madbonez

Compare Tickmcp with

TickmcpvsNotion TickmcpvsLinear TickmcpvsGoogle Drive Tickmcpvsmindsdb/mindsdb Tickmcpvsfulcradynamics/fulcra-context-mcp Tickmcpvsaymericzip/intlayer Tickmcpvsrinadelph/Agent-MCP TickmcpvsWhenLabs-org/when TickmcpvsBeltran12138/wecom-docs-mcp-server Tickmcpvsmadbonez/caldav-mcp

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All productivity MCPs