de en es ja ko ru zh

TickTick MCP Server

Name: TickTick MCP Server
Author: jawello

by jawello

Overview Schema Related Servers Score Discussions

Python

Local

TickTick MCP Server -- La integración completa de TickTick para Claude

License: MIT Version Python Tools Glama

28 herramientas. CRUD completo. Consultas inteligentes. Filtros multicondición. Operaciones por lotes. Soporte GTD. Compatible con Dida365.

Conecta Claude a tu cuenta de TickTick y gestiona todo tu sistema de tareas mediante conversación natural: crea tareas, busca en todos los proyectos, comprueba lo que está vencido, crea elementos por lotes y mantente organizado sin abrir la aplicación.

"¿Qué está vencido?" --> Muestra al instante todos los plazos incumplidos en todos los proyectos.

¿Por qué este?

Característica	Este servidor	TickTick Official MCP	jacepark12
Herramientas	28	22	~20
Filtro multicondición	Sí (prioridad + etiqueta + fecha + proyecto)	Sí	No
Mover tarea entre proyectos	Sí	Sí	No
Completado masivo	Sí (hasta 20)	Sí (hasta 20)	No
Actualización por lotes	Sí	Sí	No
Vista de tareas completadas	Sí	Sí	No
Búsqueda entre proyectos	Búsqueda de texto completo	Sí	Sí
Subtareas	Sí	No	No
Vista de enfoque GTD	Sí (prioridad alta + vencido + atrasado)	No	Parcial
Soporte Dida365	Sí (URL base configurable)	No	Sí
Asíncrono (httpx)	Sí	N/A	No (solicitudes síncronas)
Validación Pydantic	Sí (entradas tipadas)	N/A	No
Anotaciones MCP	Sí (readOnly, sugerencias destructivas)	N/A	No
Autohospedado / código abierto	Sí	No (servicio alojado)	Sí
Privacidad	100% local, solo tus tokens	Pasa por los servidores de TickTick	100% local

Related MCP server: TickTick MCP

Inicio rápido

Requisitos previos

Cuenta de TickTick
Python 3.10+
Claude Code o Claude Desktop

Paso 1 -- Clonar e instalar

git clone https://github.com/Salen-Project/ticktick-mcp
cd ticktick-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

Paso 2 -- Registra una aplicación de desarrollador de TickTick

Ve a developer.ticktick.com
Haz clic en Nueva aplicación y escribe cualquier nombre
Establece la URL de redirección OAuth en: http://localhost:8080/callback
Copia tu ID de cliente y Secreto de cliente

Paso 3 -- Autenticarse

TICKTICK_CLIENT_ID=your_id TICKTICK_CLIENT_SECRET=your_secret .venv/bin/python3 setup_auth.py

Esto abre tu navegador para autorizar la aplicación. Haz clic en Permitir: los tokens se guardan en ~/.ticktick_mcp/tokens.json y se actualizan automáticamente.

Paso 4 -- Regístrate con Claude Code

claude mcp add ticktick \
  -e TICKTICK_CLIENT_ID=your_id \
  -e TICKTICK_CLIENT_SECRET=your_secret \
  -- /path/to/ticktick-mcp/.venv/bin/python3 /path/to/ticktick-mcp/server.py

Para Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "ticktick": {
      "type": "stdio",
      "command": "/path/to/ticktick-mcp/.venv/bin/python3",
      "args": ["/path/to/ticktick-mcp/server.py"],
      "env": {
        "TICKTICK_CLIENT_ID": "your_id",
        "TICKTICK_CLIENT_SECRET": "your_secret"
      }
    }
  }
}

Paso 5 -- Añade la habilidad de productividad (opcional)

mkdir -p ~/.claude/skills/ticktick
cp skills/ticktick/SKILL.md ~/.claude/skills/ticktick/

Soporte Dida365

Para Dida365 (la versión china de TickTick), establece estas variables de entorno:

TICKTICK_BASE_URL=https://api.dida365.com/open/v1
TICKTICK_TOKEN_URL=https://dida365.com/oauth/token

Ejemplos de uso

Tú dices	Qué ocurre
"Recuérdame llamar al dentista el viernes"	Tarea creada con fecha de vencimiento
"Añade 'revisar informe del Q1' a Trabajo, prioridad alta"	Tarea en el proyecto Trabajo, prioridad 5
"¿Qué está vencido?"	Muestra todas las tareas vencidas en todos los proyectos
"¿En qué debería centrarme?"	Vista GTD: prioridad alta + vence hoy + vencidas
"Busca cualquier cosa sobre 'presupuesto'"	Búsqueda de texto completo en todos los proyectos
"Muéstrame todas las tareas de prioridad alta"	Filtra por prioridad=5 en todos los proyectos
"¿Qué vence esta semana?"	Tareas que vencen en los próximos 7 días
"Crea tareas: comprar leche, llamar a Juan, enviar informe"	Crea 3 tareas por lotes
"Crea un proyecto llamado 'Planificación de vacaciones'"	Nuevo proyecto creado
"Añade la subtarea 'Comprar protector solar' bajo la tarea de vacaciones"	Subtarea creada
"He terminado la tarea del dentista"	Tarea marcada como completada
"Elimina el antiguo proyecto Sprint"	Proyecto y todas las tareas eliminados

Referencia de herramientas MCP

Proyectos (5 herramientas)

Herramienta	Descripción
`ticktick_list_projects`	Lista todos los proyectos con IDs, nombres, colores
`ticktick_get_project`	Obtén detalles de un proyecto específico
`ticktick_get_project_with_tasks`	Obtén detalles del proyecto + todas las tareas pendientes en una sola llamada
`ticktick_create_project`	Crea un nuevo proyecto (nombre, color, modo de vista)
`ticktick_update_project`	Actualiza el nombre, color o modo de vista de un proyecto
`ticktick_delete_project`	Elimina permanentemente un proyecto

Tareas -- CRUD básico (7 herramientas)

Herramienta	Descripción
`ticktick_list_tasks`	Lista todas las tareas en un proyecto específico
`ticktick_create_task`	Crea una tarea (título, fecha de vencimiento, prioridad, proyecto, etiquetas)
`ticktick_get_task`	Obtén todos los detalles de una tarea específica
`ticktick_update_task`	Actualiza título, contenido, fechas o prioridad
`ticktick_complete_task`	Marca una tarea como completada
`ticktick_delete_task`	Elimina permanentemente una tarea
`ticktick_create_subtask`	Crea una subtarea bajo una tarea principal

Tareas -- Consultas inteligentes (7 herramientas)

Herramienta	Descripción
`ticktick_get_all_tasks`	Obtén todas las tareas de todos los proyectos activos
`ticktick_search_tasks`	Búsqueda de texto completo en títulos, contenido, subtareas
`ticktick_get_tasks_by_priority`	Filtra por prioridad (Ninguna/Baja/Media/Alta)
`ticktick_get_tasks_due_today`	Tareas que vencen hoy en todos los proyectos
`ticktick_get_overdue_tasks`	Todas las tareas vencidas en todos los proyectos
`ticktick_get_tasks_due_this_week`	Tareas que vencen en los próximos 7 días
`ticktick_get_tasks_due_in_days`	Tareas que vencen exactamente en N días

Tareas -- Lote y productividad (5 herramientas)

Herramienta	Descripción
`ticktick_batch_create_tasks`	Crea varias tareas a la vez
`ticktick_batch_update_tasks`	Actualiza varias tareas a la vez
`ticktick_complete_tasks_bulk`	Marca hasta 20 tareas como completadas a la vez
`ticktick_move_task`	Mueve una tarea de un proyecto a otro
`ticktick_get_focus_tasks`	Vista de enfoque GTD: prioridad alta + vence hoy + vencidas

Tareas -- Filtros avanzados (2 herramientas)

Herramienta	Descripción
`ticktick_filter_tasks`	Filtro multicondición: prioridad + etiqueta + rango de fechas + proyecto + estado
`ticktick_get_completed_tasks`	Ver tareas completadas en un proyecto

Usuario (1 herramienta)

Herramienta	Descripción
`ticktick_get_user_preferences`	Obtén la configuración del usuario (zona horaria, inicio de semana, etc.)

Arquitectura

ticktick_mcp/server.py # All MCP tools, async httpx, flat tool arguments
server.py              # Thin entry point re-exporting the package
setup_auth.py          # One-time OAuth 2.0 setup (browser-based)
~/.ticktick_mcp/       # Token storage (auto-refreshed)
skills/ticktick/       # Claude skill for natural task language

Decisiones de diseño:

Asíncrono en todas partes -- httpx.AsyncClient para llamadas API no bloqueantes
Argumentos de herramienta planos -- Annotated[T, Field(...)] por argumento, no un único objeto params: los agentes producen argumentos planos de forma fiable y suelen omitir un envoltorio
Anotaciones MCP -- readOnlyHint, destructiveHint para un uso más seguro de las herramientas
Actualización automática de tokens -- Los tokens se actualizan de forma transparente con un margen de 60 segundos

Solución de problemas

"El ID de cliente proporcionado no coincide" -- Vuelve a comprobar tu ID de cliente en developer.ticktick.com.

El puerto 8080 ya está en uso -- lsof -ti:8080 | xargs kill -9 y luego reintenta.

Tokens caducados -- Vuelve a ejecutar setup_auth.py para obtener tokens nuevos.

Claude no ve las herramientas -- Ejecuta claude mcp list para verificar el registro.

Contribuciones

¡Las contribuciones son bienvenidas! Abre primero un issue para discutir lo que te gustaría cambiar.

git clone https://github.com/Salen-Project/ticktick-mcp
cd ticktick-mcp
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
# Make your changes to server.py
# Test: python3 -c "from server import mcp; print(len(mcp._tool_manager._tools), 'tools')"

Enlaces

Licencia

MIT (c) Salen-Project

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

CalmLoop Task Manager
in.calmloop
Manage tasks, Focus Zone, notes, projects, and task history from compatible AI assistants.
Project Management Note Taking
1
platform7n
tech.p7n
Connect Claude to your Platform7n workspaces — chat, links, and tasks. One-click OAuth.
Communication Project Management Workplace & Productivity
2
constants
io.github.constants-ai
One workspace of tools for Claude and ChatGPT: connect 600+ apps, generate media, build tools.
App Automation Developer Tools Multimedia Processing
1
skr-cloudify-clickup-mcp-server-new
ai.smithery
Manage your ClickUp workspace by creating, updating, and organizing tasks, lists, folders, and tag…
Project Management App Automation Workplace & Productivity
2

Related MCP Servers

ticktick-mcp
App Automation Project Management Workplace & Productivity
abdulhamid-n
A
license
A
quality
C
maintenance
MCP server for TickTick using the official OAuth 2.0 API. Create, list, update, complete, and delete tasks just by talking to Claude.
Updated 5 months ago (2026-04-06 19:38 UTC)
7
3
MIT
TickTick MCP
Project Management Workplace & Productivity
ekkyarmandi
A
license
Not graded
quality
D
maintenance
Enables AI assistants to manage TickTick tasks through natural language, including creating, updating, completing, and deleting tasks, as well as managing projects.
Updated 4 months ago (2026-04-24 02:17 UTC)
14
MIT
mcp-server-ticktick
Project Management Workplace & Productivity
broven
F
license
Not graded
quality
D
maintenance
Enables interacting with TickTick tasks and projects through natural language via Claude and other MCP clients.
Updated 7 months ago (2026-02-13 16:15 UTC)
TickTick MCP Server
Project Management App Automation
AdityaKhandelwal10
F
license
Not graded
quality
D
maintenance
Enables AI assistants to manage TickTick tasks including listing, creating, updating, completing, and deleting tasks, as well as searching and filtering.
Updated 10 months ago (2025-11-07 10:00 UTC)

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jawello/ticktick-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server