Things MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_inboxC | Get todos from Inbox |
| get_todayB | Get todos due today |
| get_upcomingB | Get upcoming todos |
| get_anytimeC | Get todos from Anytime list |
| get_somedayB | Get todos from Someday list |
| 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 |
| get_trashB | Get trashed todos |
| 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 |
| get_projectsC | Get all projects from Things Args: include_items: Include tasks within projects |
| get_areasC | Get all areas from Things Args: include_items: Include projects and tasks within areas |
| get_tagsC | Get all tags Args: include_items: Include items tagged with each tag |
| get_tagged_itemsC | Get items with a specific tag Args: tag: Tag title to filter by |
| get_headingsC | Get headings from Things Args: project_uuid: Optional UUID of a specific project to get headings from |
| search_todosC | Search todos by title or notes Args: query: Search term to look for in todo titles and notes |
| 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) |
| get_recentC | Get recently created items Args: period: Time period (e.g., '3d', '1w', '2m', '1y') |
| 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) |
| 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 |
| 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) |
| 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 |
| 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 |
| search_itemsC | Search for items in Things Args: query: Search query |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
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/hald/things-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server