Skip to main content
Glama
Things MCP Server

Things MCP Server

by hald

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)

  1. Prerrequisitos

  • Python 3.12+

  • Escritorio de Claude

  • Cosas 3 ("Habilitar URL de Cosas" debe estar activado en Configuración -> General)

  1. Instale uv si aún no lo ha hecho:

curl -LsSf https://astral.sh/uv/install.sh | sh

Luego reinicie su terminal.

  1. Clonar este repositorio:

git clone https://github.com/hald/things-mcp
  1. Instale los paquetes de Python necesarios:

cd things-mcp
uv venv
uv pip install -r pyproject.toml
  1. Editar el archivo de configuración de Claude Desktop:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Agregue 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 entrada

  • get-today - Obtener las tareas pendientes que vencen hoy

  • get-upcoming - Obtén tus próximas tareas pendientes

  • get-anytime - Obtener tareas pendientes de la lista Anytime

  • get-someday - Obtener tareas pendientes de la lista Someday

  • get-logbook - Obtener tareas completadas

  • get-trash - Obtener todos los archivos eliminados

Operaciones básicas

  • get-todos - Obtener todos, opcionalmente filtrados por proyecto

  • get-projects - Obtener todos los proyectos

  • get-areas - Obtener todas las áreas

Operaciones de etiquetas

  • get-tags - Obtener todas las etiquetas

  • get-tagged-items - Obtener elementos con una etiqueta específica

Operaciones de búsqueda

  • search-todos - Búsqueda simple por título/notas

  • search-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 proyecto

  • include_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 etiqueta

  • area - Filtrar por UUID de área

  • type - 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*.log

Available Tools

22 tools
add_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

    B3.2/5.0

    Scored across 22 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessMixed handling

    Related MCP Connectors

    Related MCP Servers