MCP ExplorerExplorer

Things Mcp

@BMPixelon 14 days ago
1 MIT
FreeCommunity
AI Systems
Things MCP Server allows AI assistants to manage Tasks in Things.app on macOS.

Overview

What is Things Mcp

Things MCP is a server that allows AI assistants to interact with tasks in the Things.app on macOS using the Model Context Protocol (MCP).

Use cases

Use cases include daily planning, managing marketing campaigns, and organizing personal or professional projects effectively.

How to use

To use Things MCP, you need to obtain an authorization token from Things.app, configure your AI assistant with this token, and restart the assistant to enable the MCP server.

Key features

Key features include creating and updating tasks, viewing detailed summaries of your task database, scheduling tasks for specific dates, and organizing tasks with areas, tags, and deadlines.

Where to use

Things MCP can be used in personal productivity, project management, and task organization across various domains where task management is essential.

Content

Things MCP Server

npm version
License: MIT
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

Claude Desktop

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"
      }
    }
  }
}
Cursor IDE

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"
    }
  }
}

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.

Tools

No tools

Comments