这个模型上下文协议（MCP）服务器允许你使用 Claude Desktop 与 Culture Code 中的任务管理数据交互。你可以让 Claude 创建任务、分析项目、帮助管理优先级等。

该服务器利用 Things.py 库和Things URL方案。

支持项目

如果您觉得这个项目有帮助，请考虑支持其开发：

特色

• 访问所有主要事项列表（收件箱、今日、即将上市等）
• 项目与区域管理
• 标签操作
• 高级搜索功能
• 近期项目
• 详细的项目信息，包括检查清单
• 支持嵌套数据（区域内项目，项目内待办事项）
• Someday 项目过滤：Someday 项目中的任务自动排除在 Today、Upcoming 和 Anytime 视图中，以匹配 Things 的界面行为

安装

先决条件

• macOS（Things 3仅支持Mac）
• Things 3 应用开启“启用 Things URLS”（设置→通用）
• MCP客户端，如Claude Desktop或Claude代码
• uv Python 包管理器：brew install uv

通过 UVX 安装（任意 MCP 客户端）

Things MCP发布在PyPI上，可以直接运行uvx：

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:

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

Prerequisites

• macOS (Things 3 is Mac-only)
• Things 3 app with “Enable Things URLs” turned on (Settings → General)
• An MCP client, such as the ChatGPT desktop app, Codex, Claude Desktop, or Claude Code
• uv Python package manager: brew install uv

Install via uvx (Any MCP Client)

Things MCP is published on PyPI and can be run directly with uvx:

uvx things-mcp

Configure your MCP client to use uvx with things-mcp as the argument.

Claude Desktop

Option 1: One-Click Install (Recommended)

1. Download the latest file from the releases page
2. Double-click the .mcpb file
3. Done!

Option 2: Manual Config

1. Go to Claude → Settings → Developer → Edit Config
2. Add the Things server:

{
  "mcpServers": {
    "things": {
      "command": "uvx",
      "args": ["things-mcp"]
    }
  }
}

3. Save and restart Claude Desktop

Claude Code

claude mcp add-json things '{"command":"uvx","args":["things-mcp"]}'

To make it available globally (across all projects), add -s user:

claude mcp add-json -s user things '{"command":"uvx","args":["things-mcp"]}'

ChatGPT Desktop and Codex

The ChatGPT desktop app, Codex CLI, and Codex IDE extension share the same local MCP configuration. The quickest way to add Things MCP is with the Codex CLI:

codex mcp add things -- uvx things-mcp

Confirm that the server is configured:

codex mcp list

You can also configure it in the ChatGPT desktop app:

1. Open Settings → MCP servers
2. Select Add server