hald avatar

Things

hald/things-mcp

The Things MCP server enables Claude to interact with Cultured Code's Things 3 task management application on macOS by providing access to lists (Inbox, Today, Upcoming), projects, areas, tags, and search capabilities. It leverages the Things.py library and URL scheme to allow users to create tasks, analyze projects, manage priorities, and conduct productivity reviews through natural language conversation. This integration solves the problem of bridging Claude's capabilities with Things 3 data, enabling AI-assisted task management and productivity analysis without leaving the Claude interface.

GitHub stars
467
tools
25
last updated
Jan 31, 2026

Tools

25 tools

Public tool metadata for what this MCP can expose to an agent.

get-inboxGet todos from Inbox

Get todos from Inbox

No parameter schema in public metadata yet.

get-todayGet todos due today

Get todos due today

No parameter schema in public metadata yet.

get-upcomingGet upcoming todos

Get upcoming todos

No parameter schema in public metadata yet.

get-anytimeGet todos from Anytime list

Get todos from Anytime list

No parameter schema in public metadata yet.

get-somedayGet todos from Someday list, including tasks in Someday projects

Get todos from Someday list, including tasks in Someday projects

No parameter schema in public metadata yet.

get-logbookGet completed and canceled todos, optionally for one project

Get completed and canceled todos, optionally for one project

No parameter schema in public metadata yet.

get-trashGet trashed todos

Get trashed todos

No parameter schema in public metadata yet.

get-todosGet todos, optionally filtered by project

Get todos, optionally filtered by project

No parameter schema in public metadata yet.

get-projectsGet all projects

Get all projects

No parameter schema in public metadata yet.

get-areasGet all areas

Get all areas

No parameter schema in public metadata yet.

get-tagsGet all tags

Get all tags

No parameter schema in public metadata yet.

get-tagged-itemsGet items with a specific tag

Get items with a specific tag

No parameter schema in public metadata yet.

get-tag-usageReport how many items use each tag, sorted by usage; flag unused tags for cleanup

Report how many items use each tag, sorted by usage; flag unused tags for cleanup

No parameter schema in public metadata yet.

search-todosSimple search by title/notes

Simple search by title/notes

No parameter schema in public metadata yet.

search-advancedAdvanced search with multiple filters

Advanced search with multiple filters

No parameter schema in public metadata yet.

get-recentGet open items created within a rolling time window

Get open items created within a rolling time window

No parameter schema in public metadata yet.

add-todoCreate a new todo

Create a new todo

No parameter schema in public metadata yet.

add-projectCreate a new project

Create a new project

No parameter schema in public metadata yet.

add-areaCreate a new Area (via AppleScript; Things URL scheme has no add-area command)

Create a new Area (via AppleScript; Things URL scheme has no add-area command)

No parameter schema in public metadata yet.

update-areaUpdate an existing Area: rename or set tags (via AppleScript)

Update an existing Area: rename or set tags (via AppleScript)

No parameter schema in public metadata yet.

update-todoUpdate an existing todo

Update an existing todo

No parameter schema in public metadata yet.

bulk-update-todosApply the same update to many todos in a single operation

Apply the same update to many todos in a single operation

No parameter schema in public metadata yet.

update-projectUpdate an existing project

Update an existing project

No parameter schema in public metadata yet.

show-itemShow a specific item or list in Things

Show a specific item or list in Things

No parameter schema in public metadata yet.

search-itemsSearch for items in Things

Search for items in Things

No parameter schema in public metadata yet.

Sponsors

Readme

Things MCP Server

This Model Context Protocol (MCP) server lets you use ChatGPT, Codex, Claude Desktop, and other MCP clients to interact with your task management data in Things 3 from Cultured Code. You can ask your assistant to create tasks, analyze projects, help manage priorities, and more.

This server leverages the Things.py library and the Things URL Scheme.

Support the Project

If you find this project helpful, consider supporting its development:

ko-fi

Features

  • Access to all major Things lists (Inbox, Today, Upcoming, etc.)
  • Project and area management
  • Tag operations
  • Advanced search capabilities
  • Recent items
  • Detailed item information including checklists
  • Support for nested data (projects within areas, todos within projects)
  • Someday project filtering: tasks in Someday projects are automatically excluded from Today, Upcoming, and Anytime views, matching Things UI behavior

Installation


View the full README on GitHub

Details

Repository
github.com/hald/things-mcp
Categories
Data & Analytics, Productivity & Office

Related Data & Analytics MCP servers

View all
1koreal6803 avatarFinlab Aikoreal6803/finlab-aiQuantitative trading toolkit with 900+ data columns, backtesting, and 60+ strategy examples.425stars
2blockrunai avatarBlockrun Mcpblockrunai/blockrun-mcpWeb search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.390stars
3ryaker avatarModular Outlookryaker/outlook-mcpProvides OAuth-authenticated access to Outlook data via MCP enabling email and calendar actions.372stars
4imnmv avatarClaudeR - RStudio MCP Serverimnmv/clauderConnect RStudio to AI assistants for interactive R coding and data analysis.365stars
5massive-com avatarMassive.commassive-com/mcp_massiveProvides access to Massive.com data via an MCP server with four composable tools and in-memory DataFrame storage for SQL queries and analytics.332stars
6gomarble-ai avatarFacebook Adsgomarble-ai/facebook-ads-mcp-serverProvides an interface to Meta Ads, enabling programmatic access to data, campaigns, and insights via an MCP client.324stars