MCPgee
MCPgee
MCPgeeMCPgee

Things MCP

v1.0.0•Business Applications•stable

Create a new to-do item in Things.app. Add notes, tags, checklist items, and assign to projects or areas.

mcpmcp-serverthings3
Share:
34
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Things MCP?

Things MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to create a new to-do item in things.app. add notes, tags, checklist items, and assign to projects or areas.

Create a new to-do item in Things.app. Add notes, tags, checklist items, and assign to projects or areas.

This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • add_todo
  • add_project
  • update_todo
  • update_project
  • things_summary

Use Cases

Create to-do items in Things.app with notes and tags.
Assign tasks to projects and areas.
Add checklists to tasks programmatically.
ebowman

Maintainer

LicenseNOASSERTION
Languagepython
Versionv1.0.0
UpdatedApr 27, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

NPM

npx -y @wenbopan/things-mcp

Manual Installation

npx -y @wenbopan/things-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Things MCP

The Things MCP Server connects Claude and other AI assistants to Things 3, the award-winning task manager for macOS and iOS. It exposes full CRUD operations on todos, projects, and areas via AppleScript, so you can create richly annotated tasks, assign them to projects, add checklists and due dates, and search your entire task library — all from natural language. This is particularly useful for knowledge workers who want to capture action items from meetings, documents, or conversations directly into their task system without leaving their AI assistant.

Prerequisites

  • macOS with Things 3 installed and running (the app must be open for AppleScript to work)
  • Python 3.10 or later
  • pip or a virtual-environment tool (venv/uv) for package installation
  • An MCP client such as Claude Desktop
1

Create a Python virtual environment

Isolate the server's dependencies from your system Python to avoid conflicts.

python3 -m venv venv && source venv/bin/activate
2

Install the mcp-server-things package

Install directly from PyPI. This pulls in the MCP SDK and AppleScript bridge.

pip install mcp-server-things
3

Note the Python executable path

You will need the absolute path to the venv's Python binary for the Claude Desktop config.

which python
4

Add the server to Claude Desktop

Open claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) and add the mcpServers entry below. Replace /path/to/venv with your actual venv path.

5

Restart Claude Desktop

Quit and reopen Claude Desktop so it picks up the new server configuration. Things 3 must also be running in the background.

Things MCP Examples

Client configuration

Add this block to claude_desktop_config.json. Adjust the Python path and set any optional env vars to tune behaviour.

{
  "mcpServers": {
    "things": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "things_mcp"],
      "env": {
        "THINGS_MCP_LOG_LEVEL": "INFO",
        "THINGS_MCP_APPLESCRIPT_TIMEOUT": "30",
        "THINGS_MCP_AI_CAN_CREATE_TAGS": "true"
      }
    }
  }
}

Prompts to try

These prompts exercise the main capabilities of the server once it is connected.

- "Create a todo called 'Review Q3 report' with a note 'Focus on revenue section', due tomorrow, tagged Finance, in the Work project"
- "Show me everything in my Things inbox"
- "Move all tasks tagged 'Waiting' to Someday"
- "Add a checklist to my 'Launch website' project with items: write copy, review designs, deploy"
- "Search my tasks for anything mentioning 'budget'"

Troubleshooting Things MCP

AppleScript permission error or 'Things is not running'

Open Things 3 before invoking any tool. Also grant Claude Desktop (or Terminal) Automation permissions in System Settings > Privacy & Security > Automation.

Server not found in Claude Desktop after config change

Verify the Python path is the absolute path inside the venv (e.g. /Users/you/venv/bin/python), not just 'python'. Validate the JSON syntax of claude_desktop_config.json before restarting.

Tags are not being created even though AI_CAN_CREATE_TAGS is true

Set THINGS_MCP_AI_CAN_CREATE_TAGS=true in the env block of the config. The default is false for safety — the server will only use existing tags unless this flag is explicitly enabled.

Frequently Asked Questions about Things MCP

What is Things MCP?

Things MCP is a Model Context Protocol (MCP) server that create a new to-do item in things.app. add notes, tags, checklist items, and assign to projects or areas. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Things MCP?

Install via npm with the command: npx -y @wenbopan/things-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Things MCP?

Things MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Things MCP free to use?

Yes, Things MCP is open source and available under the NOASSERTION license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Things MCP Alternatives — Similar Business Applications Servers

Looking for alternatives to Things MCP? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.

n8n

★ 189.1k

A comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou

LobeHub

★ 77.5k

🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.

Jeecgboot

★ 46.4k

AI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。

CowAgent

★ 44.7k

CowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。

Minds Platform

★ 39.2k

Platform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.

Astrbot

★ 32.8k

AI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨

Browse More Business Applications MCP Servers

Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Business ApplicationsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "things": { "command": "npx", "args": ["-y", "@wenbopan/things-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Things MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides