Things MCP Server
Servidor MCP de Things
Este servidor de Protocolo de Contexto de Modelo (MCP) te permite usar Claude Desktop para interactuar con tus datos de gestión de tareas en la app Things . Puedes pedirle a Claude que cree tareas, analice proyectos, te ayude a gestionar prioridades y mucho más.
Este servidor aprovecha la biblioteca Things.py y el esquema de URL de Things .
Características
Acceso a todas las listas principales de cosas (Bandeja de entrada, Hoy, Próximos, etc.)
Gestión de proyectos y áreas
Operaciones de etiquetas
Capacidades de búsqueda avanzada
Seguimiento de artículos recientes
Información detallada del artículo, incluidas listas de verificación
Soporte para datos anidados (proyectos dentro de áreas, tareas pendientes dentro de proyectos)
Related MCP server: Things MCP
Instalación (para Claude Desktop)
Prerrequisitos
Python 3.12+
Escritorio de Claude
Cosas 3 ("Habilitar URL de Cosas" debe estar activado en Configuración -> General)
Instale uv si aún no lo ha hecho:
curl -LsSf https://astral.sh/uv/install.sh | shLuego reinicie su terminal.
Clonar este repositorio:
git clone https://github.com/hald/things-mcpInstale los paquetes de Python necesarios:
cd things-mcp
uv venv
uv pip install -r pyproject.tomlEditar el archivo de configuración de Claude Desktop:
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonAgregue el servidor Things a la clave mcpServers al archivo de configuración (asegúrese de actualizar la ruta a la carpeta donde instaló estos archivos):
{
"mcpServers": {
"things": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
"run",
"things_server.py"
]
}
}
}Reinicie la aplicación Claude Desktop.
Ejemplo de uso con Claude Desktop
"¿Qué hay en mi lista de tareas para hoy?"
"Crea una lista de cosas por hacer para preparar el equipaje para mis vacaciones en la playa la próxima semana. Incluye una lista de verificación para empacar".
"Evalúa mis tareas actuales utilizando la matriz de Eisenhower".
"Ayúdame a realizar una revisión semanal al estilo GTD usando Things".
Consejos
Crea un proyecto en Claude con instrucciones personalizadas que expliquen cómo usar Things y organizar áreas, proyectos, etiquetas, etc. Dile a Claude qué información quieres que se incluya cuando cree una nueva tarea (por ejemplo, pedirle que incluya detalles relevantes en la descripción de la tarea podría ser útil).
Intenta agregar otro servidor MCP que le dé a Claude acceso a tu calendario. Esto te permitirá pedirle que bloquee tiempo en tu calendario para tareas específicas, cree tareas a partir de próximos eventos del calendario (por ejemplo, prepararse para una reunión), etc.
Herramientas disponibles
Vistas de lista
get-inbox- Obtener todos los archivos de la Bandeja de entradaget-today- Obtener las tareas pendientes que vencen hoyget-upcoming- Obtén tus próximas tareas pendientesget-anytime- Obtener tareas pendientes de la lista Anytimeget-someday- Obtener tareas pendientes de la lista Somedayget-logbook- Obtener tareas completadasget-trash- Obtener todos los archivos eliminados
Operaciones básicas
get-todos- Obtener todos, opcionalmente filtrados por proyectoget-projects- Obtener todos los proyectosget-areas- Obtener todas las áreas
Operaciones de etiquetas
get-tags- Obtener todas las etiquetasget-tagged-items- Obtener elementos con una etiqueta específica
Operaciones de búsqueda
search-todos- Búsqueda simple por título/notassearch-advanced- Búsqueda avanzada con múltiples filtros
Operaciones basadas en el tiempo
get-recent- Obtener elementos creados recientemente
Parámetros de la herramienta
tareas pendientes
project_uuid(opcional) - Filtrar tareas por proyectoinclude_items(opcional, valor predeterminado: verdadero): incluye elementos de la lista de verificación
obtener-proyectos / obtener-áreas / obtener-etiquetas
include_items(opcional, predeterminado: falso): incluye elementos contenidos
búsqueda avanzada
status- Filtrar por estado (incompleto/completado/cancelado)start_date- Filtrar por fecha de inicio (AAAA-MM-DD)deadline- Filtrar por fecha límite (AAAA-MM-DD)tag- Filtrar por etiquetaarea- Filtrar por UUID de áreatype- Filtrar por tipo de elemento (tareas pendientes/proyecto/encabezado)
obtener reciente
period- Período de tiempo (por ejemplo, '3d', '1s', '2m', '1y')
Solución de problemas
El servidor incluye gestión de errores para:
UUID no válidos
Faltan parámetros requeridos
Errores de acceso a la base de datos de Things
Errores de formato de datos
Todos los errores se registran y se devuelven con mensajes descriptivos. Para revisar los registros de MCP desde Claude Desktop, ejecute lo siguiente en la terminal:
# Follow logs in real-time
tail -n 20 -f ~/Library/Logs/Claude/mcp*.logAvailable Tools
22 toolsadd_projectB
Create a new project in Things
Args: title: Title of the project notes: Notes for the project when: When to schedule the project deadline: Deadline for the project tags: Tags to apply to the project area_id: ID of area to add to area_title: Title of area to add to todos: Initial todos to create in the project
Inputs: title (required), area_id, area_title, deadline, +4 more. Returns: result
add_todoB
Create a new todo in Things
Args: title: Title of the todo notes: Notes for the todo when: When to schedule the todo (today, tomorrow, evening, anytime, someday, or YYYY-MM-DD) deadline: Deadline for the todo (YYYY-MM-DD) tags: Tags to apply to the todo checklist_items: Checklist items to add list_id: ID of project/area to add to list_title: Title of project/area to add to heading: Heading title to add under heading_id: Heading ID to add under (takes precedence over heading)
Inputs: title (required), checklist_items, deadline, heading, +6 more. Returns: result
get_anytimeC
Get todos from Anytime list
Inputs: no named parameters. Returns: result
get_areasC
Get all areas from Things
Args: include_items: Include projects and tasks within areas
Inputs: include_items. Returns: result
get_headingsC
Get headings from Things
Args: project_uuid: Optional UUID of a specific project to get headings from
Inputs: project_uuid. Returns: result
get_inboxC
Get todos from Inbox
Inputs: no named parameters. Returns: result
get_logbookA
Get completed todos from Logbook, defaults to last 7 days
Args: period: Time period to look back (e.g., '3d', '1w', '2m', '1y'). Defaults to '7d' limit: Maximum number of entries to return. Defaults to 50
Inputs: limit, period. Returns: result
get_projectsC
Get all projects from Things
Args: include_items: Include tasks within projects
Inputs: include_items. Returns: result
get_recentC
Get recently created items
Args: period: Time period (e.g., '3d', '1w', '2m', '1y')
Inputs: period (required). Returns: result
get_somedayB
Get todos from Someday list
Inputs: no named parameters. Returns: result
get_tagged_itemsC
Get items with a specific tag
Args: tag: Tag title to filter by
Inputs: tag (required). Returns: result
get_tagsC
Get all tags
Args: include_items: Include items tagged with each tag
Inputs: include_items. Returns: result
get_todayB
Get todos due today
Inputs: no named parameters. Returns: result
get_todosB
Get todos from Things, optionally filtered by project
Args: project_uuid: Optional UUID of a specific project to get todos from include_items: Include checklist items
Inputs: include_items, project_uuid. Returns: result
get_trashB
Get trashed todos
Inputs: no named parameters. Returns: result
get_upcomingB
Get upcoming todos
Inputs: no named parameters. Returns: result
search_advancedB
Advanced todo search with multiple filters
Args: status: Filter by todo status (incomplete, completed, canceled) start_date: Filter by start date (YYYY-MM-DD) deadline: Filter by deadline (YYYY-MM-DD) tag: Filter by tag area: Filter by area UUID type: Filter by item type (to-do, project, heading)
Inputs: area, deadline, start_date, status, +2 more. Returns: result
search_itemsC
Search for items in Things
Args: query: Search query
Inputs: query (required). Returns: result
search_todosC
Search todos by title or notes
Args: query: Search term to look for in todo titles and notes
Inputs: query (required). Returns: result
show_itemB
Show a specific item or list in Things
Args: id: ID of item to show, or one of: inbox, today, upcoming, anytime, someday, logbook query: Optional query to filter by filter_tags: Optional tags to filter by
Inputs: id (required), filter_tags, query. Returns: result
update_projectB
Update an existing project in Things
Args: id: ID of the project to update title: New title notes: New notes when: New schedule deadline: New deadline tags: New tags completed: Mark as completed canceled: Mark as canceled
Inputs: id (required), canceled, completed, deadline, +4 more. Returns: result
update_todoB
Update an existing todo in Things
Args: id: ID of the todo to update title: New title notes: New notes when: New schedule deadline: New deadline tags: New tags completed: Mark as completed canceled: Mark as canceled list: The title of a project or area to move the to-do into list_id: The ID of a project or area to move the to-do into (takes precedence over list) heading: The heading title to move the to-do under heading_id: The heading ID to move the to-do under (takes precedence over heading)
Inputs: id (required), canceled, completed, deadline, +8 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
Most tools have distinct purposes targeting specific resources like projects, todos, areas, or lists, with clear separation between creation, retrieval, and update operations. However, there is some overlap between search_items, search_todos, and search_advanced, which could cause confusion about which to use for different search scenarios.
Tool names follow a highly consistent verb_noun pattern throughout, with verbs like add, get, update, and search paired with specific nouns (e.g., add_project, get_areas, update_todo, search_items). All names use snake_case uniformly, making the set predictable and easy to navigate.
With 22 tools, the count is on the higher side for a task management server, bordering on heavy. While many tools serve distinct functions, the number might feel overwhelming compared to a more streamlined set, though it's not extreme given the domain's complexity.
The tool set provides comprehensive coverage for task management, including full CRUD operations for projects and todos, retrieval of various lists (e.g., inbox, today, upcoming), search capabilities, and management of related entities like areas, tags, and headings. No obvious gaps exist for core workflows.
Maintenance
Related MCP Connectors
Capture, clarify and plan your tasks from Claude or ChatGPT. Built around the GTD methodology.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceLets you use Claude Desktop to interact with your task management data in Things app, enabling you to create tasks, analyze projects, manage priorities, and implement productivity workflows through natural language.35MIT
- FlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 on macOS, allowing users to create, update, and manage to-dos and projects, list tasks, search items, and navigate through Things lists using natural language.2016-
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 task management, allowing creation, analysis, and management of tasks, projects, and tags via natural language.22MIT
- AlicenseBqualityDmaintenanceEnables Claude to interact with Things 3 task management, allowing natural language task creation, project analysis, and GTD workflow automation.2473 PyPI44MIT