Servidor MCP TickTick
Un servidor de Protocolo de contexto de modelo (MCP) para TickTick que permite interactuar con su sistema de gestión de tareas TickTick directamente a través de Claude y otros clientes MCP.
Características
- 📋 Ver todos tus proyectos y tareas de TickTick
- ✏️ Crea nuevos proyectos y tareas a través del lenguaje natural
- 🔄 Actualizar los detalles de las tareas existentes (título, contenido, fechas, prioridad)
- ✅ Marcar tareas como completadas
- 🗑️ Eliminar tareas y proyectos
- 🔄 Integración completa con la API abierta de TickTick
- 🔌 Integración perfecta con Claude y otros clientes de MCP
Prerrequisitos
- Python 3.10 o superior
- uv - Instalador y solucionador rápido de paquetes de Python
- Cuenta TickTick con acceso a la API
- Credenciales de la API de TickTick (ID de cliente, secreto de cliente, token de acceso)
Instalación
- Clonar este repositorio :
git clone https://github.com/jacepark12/ticktick-mcp.git
cd ticktick-mcp
- Instalar con uv :
# Install uv if you don't have it already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Create a virtual environment
uv venv
# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate
# Install the package
uv pip install -e .
- Autenticarse con TickTick :
# Run the authentication flow
uv run -m ticktick_mcp.cli auth
- Solicite su ID de cliente de TickTick y su secreto de cliente
- Abra una ventana del navegador para iniciar sesión en TickTick
- Guarde automáticamente sus tokens de acceso en un archivo
.env
- Pruebe su configuración :Esto verificará que sus credenciales de TickTick funcionen correctamente.
Autenticación con TickTick
Este servidor utiliza OAuth2 para autenticarse con TickTick. El proceso de configuración es sencillo:
- Registre su aplicación en el Centro de desarrolladores de TickTick
- Establezca la URI de redirección en
http://localhost:8000/callback - Anote su ID de cliente y su secreto de cliente
- Ejecute el comando de autenticación:
uv run -m ticktick_mcp.cli auth
- Siga las instrucciones para ingresar su ID de cliente y su secreto de cliente.
- Se abrirá una ventana del navegador para que autorices la aplicación con tu cuenta TickTick
- Después de autorizar, será redirigido nuevamente a la aplicación y sus tokens de acceso se guardarán automáticamente en el archivo
.env
El servidor maneja la actualización del token automáticamente, por lo que no necesitará volver a autenticarse a menos que revoque el acceso o elimine su archivo .env .
Autenticación con Dida365
滴答清单 - Dida365 es la versión china de TickTick y el proceso de autenticación es similar. Sigue estos pasos para configurar la autenticación de Dida365:
- Registra tu aplicación en el Centro de desarrolladores de Dida365
- Establezca la URI de redirección en
http://localhost:8000/callback - Anote su ID de cliente y su secreto de cliente
- Agregue variables de entorno a su archivo
.env :TICKTICK_BASE_URL='https://api.dida365.com/open/v1'
TICKTICK_AUTH_URL='https://dida365.com/oauth/authorize'
TICKTICK_TOKEN_URL='https://dida365.com/oauth/token'
- Siga los mismos pasos de autenticación que para TickTick
Uso con Claude para escritorio
- Instalar Claude para escritorio
- Edite su archivo de configuración de Claude for Desktop:macOS :
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
notepad %APPDATA%\Claude\claude_desktop_config.json
- Agregue la configuración del servidor TickTick MCP, utilizando rutas absolutas:
{
"mcpServers": {
"ticktick": {
"command": "<absolute path to uv>",
"args": ["run", "--directory", "<absolute path to ticktick-mcp directory>", "-m", "ticktick_mcp.cli", "run"]
}
}
}
- Reiniciar Claude para escritorio
Una vez conectado, verás las herramientas del servidor TickTick MCP disponibles en Claude, indicadas por el ícono 🔨 (herramientas).
Herramientas MCP disponibles
| Herramienta | Descripción | Parámetros |
|---|
get_projects | Enumere todos sus proyectos de TickTick | Ninguno |
get_project | Obtenga detalles sobre un proyecto específico | project_id |
get_project_tasks | Enumerar todas las tareas de un proyecto | project_id |
get_task | Obtener detalles sobre una tarea específica | project_id , task_id |
create_task | Crear una nueva tarea | title , project_id , content (opcional), start_date (opcional), due_date (opcional), priority (opcional) |
update_task | Actualizar una tarea existente | task_id , project_id , title (opcional), content (opcional), start_date (opcional), due_date (opcional), priority (opcional) |
complete_task | Marcar una tarea como completada | project_id , task_id |
delete_task | Eliminar una tarea | project_id , task_id |
create_project | Crear un nuevo proyecto | name , color (opcional), view_mode (opcional) |
delete_project | Eliminar un proyecto | project_id |
Ejemplos de indicaciones para Claude
A continuación se muestran algunos ejemplos de indicaciones para usar con Claude después de conectarse al servidor TickTick MCP:
- "Muéstrame todos mis proyectos de TickTick"
- Crear una nueva tarea llamada "Finalizar la documentación del servidor MCP" en mi proyecto de trabajo con alta prioridad.
- "Enumerar todas las tareas de mi proyecto personal"
- Marca la tarea «Comprar comestibles» como completada.
- "Crea un nuevo proyecto llamado 'Planificación de vacaciones' con un color azul"
- "¿Cuándo es mi próxima fecha límite en TickTick?"
Desarrollo
Estructura del proyecto
ticktick-mcp/
├── .env.template # Template for environment variables
├── README.md # Project documentation
├── requirements.txt # Project dependencies
├── setup.py # Package setup file
├── test_server.py # Test script for server configuration
└── ticktick_mcp/ # Main package
├── __init__.py # Package initialization
├── authenticate.py # OAuth authentication utility
├── cli.py # Command-line interface
└── src/ # Source code
├── __init__.py # Module initialization
├── auth.py # OAuth authentication implementation
├── server.py # MCP server implementation
└── ticktick_client.py # TickTick API client
Flujo de autenticación
El proyecto implementa un flujo OAuth 2.0 completo para TickTick:
- Configuración inicial : el usuario proporciona su ID de cliente y secreto de API de TickTick
- Autorización del navegador : el usuario es redirigido a TickTick para otorgar acceso
- Recepción de token : un servidor local recibe la devolución de llamada OAuth con el código de autorización
- Intercambio de tokens : el código se intercambia por tokens de acceso y actualización.
- Almacenamiento de tokens : los tokens se almacenan de forma segura en el archivo
.env local - Actualización de token : el cliente actualiza automáticamente el token de acceso cuando expira
Esto simplifica la experiencia del usuario al gestionar todo el flujo OAuth de forma programada.
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
- Bifurcar el repositorio
- Crea tu rama de funciones (
git checkout -b feature/amazing-feature ) - Confirme sus cambios (
git commit -m 'Add some amazing feature' ) - Empujar a la rama (
git push origin feature/amazing-feature ) - Abrir una solicitud de extracción
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.