Things MCP Server

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):

{
  "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:

{
  "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.