Skip to main content
Glama

Things MCP Server

by hald

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
get_inbox

Get todos from Inbox

get_today

Get todos due today

get_upcoming

Get upcoming todos

get_anytime

Get todos from Anytime list

get_someday

Get todos from Someday list

get_logbook

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_trash

Get trashed todos

get_todos

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_projects

Get all projects from Things

Args: include_items: Include tasks within projects

get_areas

Get all areas from Things

Args: include_items: Include projects and tasks within areas

get_tags

Get all tags

Args: include_items: Include items tagged with each tag

get_tagged_items

Get items with a specific tag

Args: tag: Tag title to filter by

get_headings

Get headings from Things

Args: project_uuid: Optional UUID of a specific project to get headings from

search_todos

Search todos by title or notes

Args: query: Search term to look for in todo titles and notes

search_advanced

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_recent

Get recently created items

Args: period: Time period (e.g., '3d', '1w', '2m', '1y')

add_todo

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_project

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_todo

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_project

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_item

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_items

Search for items in Things

Args: query: Search query

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