Things MCP Server

# Things MCP Server [](https://badge.fury.io/js/@wenbopan%2Fthings-mcp) [](https://opensource.org/licenses/MIT) [](https://www.apple.com/macos/) Control your Things.app tasks directly from Claude Code, Claude Desktop, Cursor, and other AI assistants using the Model Context Protocol (MCP). ## What It Does This MCP server lets AI assistants interact with your Things.app tasks on macOS. You can: - **Create** new tasks and projects - **Update** existing items - **View** your task database with detailed summaries - **Schedule** tasks for specific dates - **Organize** with areas, tags, and deadlines ## Quick Start ### 1. Get Things Authorization Token For updating existing tasks, you need an authorization token: 1. Open **Things.app** on macOS 2. Go to **Things → Preferences → General** 3. Check **"Enable Things URLs"** 4. Copy the authorization token that appears ### 2. Configure Your AI Assistant <details> <summary><strong>Claude Desktop</strong></summary> Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS): ```json { "mcpServers": { "things": { "command": "npx", "args": ["@wenbopan/things-mcp"], "env": { "THINGS_AUTH_TOKEN": "your-token-here" } } } } ``` </details> <details> <summary><strong>Cursor IDE</strong></summary> Create `.cursor/mcp.json` in your project or `~/.cursor/mcp.json` globally: ```json { "things": { "command": "npx", "args": ["@wenbopan/things-mcp"], "env": { "THINGS_AUTH_TOKEN": "your-token-here" } } } ``` </details> ### 3. Restart Your AI Assistant After configuration, restart your AI assistant to load the MCP server. ## Use Cases ### Daily Planning "Show me my today's tasks and create a project for the new marketing campaign with initial tasks for research, design, and content creation." ### Project Management "Update the mobile app project to add design review and testing tasks, then schedule the design review for next Monday." ### Task Organization "Move all my unscheduled shopping tasks to the 'Personal' area and tag them with 'weekend'." ### Progress Tracking "Give me a summary of all active projects with their deadlines and completion status." ### Quick Capture "Create a task to call the dentist, schedule it for tomorrow, and set a deadline for end of week." ## License MIT ## Contributing Issues and pull requests welcome! Please ensure all tests pass before submitting.