Things MCP Server

This Model Context Protocol (MCP) server lets you use Claude Desktop to interact with your task management data in Things app. You can ask Claude to create tasks, analyze projects, help manage…

Local serverstdio

What is the Things MCP Server?

Things MCP Server is an MCP project maintained in the excelsier/things-fastmcp repository. The maintainer describes its purpose as “This Model Context Protocol (MCP) server lets you use Claude Desktop to interact with your task management data in Things app. You can ask Claude…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get-inboxGet todos from Inbox
get-todayGet todos due today
get-upcomingGet upcoming todos
get-anytimeGet todos from Anytime list
get-somedayGet todos from Someday list
get-logbookGet completed todos
get-trashGet trashed todos
get-todosGet todos, optionally filtered by project
get-projectsGet all projects
get-areasGet all areas
get-tagsGet all tags
get-tagged-itemsGet items with a specific tag
search-todosSimple search by title/notes
search-advancedAdvanced search with multiple filters
get-recentGet recently created items
add-todoCreate a new todo with full parameter support
add-projectCreate a new project with tags and todos
update-todoUpdate an existing todo
update-projectUpdate an existing project
delete-todoDelete a todo (moves to trash)
delete-projectDelete a project (moves to trash)
show-itemShow a specific item or list in Things
search-itemsSearch for items in Things
project_uuidoptional) - Filter todos by project
include_itemsoptional, default: false) - Include contained items
statusFilter by status (incomplete/completed/canceled)
start_dateFilter by start date (YYYY-MM-DD)
deadlineoptional) - New deadline
tagFilter by tag
areaFilter by area UUID
periodTime period (e.g., '3d', '1w', '2m', '1y')
titleoptional) - New title
notesoptional) - New notes
whenoptional) - New schedule
tagsoptional) - New tags
headingoptional) - Heading to add under
checklist_itemsoptional) - Checklist items to add
idID of item to show, or one of: inbox, today, upcoming, anytime, someday, logbook
completedoptional) - Mark as completed
canceledoptional) - Mark as canceled
todosoptional) - Initial todos to create in the project
queryoptional) - Optional query to filter by
filter_tagsoptional) - Optional tags to filter by

How to install the Things MCP Server

{
  "mcpServers": {
    "things": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/things-mcp",
        "run",
        "things_server.py"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.