Things3 MCP Server

Features

• Complete Things3 Integration: 25 tools covering all aspects of Things3
• TODO Management: Create, read, update, delete, complete, and uncomplete tasks
• Project & Area Management: Full project lifecycle support with area organization and deletion
• Tag System: Hierarchical tag support with creation, deletion, and bulk tag operations
• Bulk Operations: Efficiently move or update multiple items at once
• Automatic Tag Creation: Tags are automatically created when referenced in TODO/project operations
• Error Correction: Automatic fixing of common issues (date conflicts, missing titles)
• Logbook Search: Search completed items with date range filtering
• Performance Optimized: Connection pooling and AppleScript optimization

Requirements

• macOS (Things3 is macOS-only)
• Node.js >= 16.0.0
• Things3 app installed
• AppleScript access enabled in System Settings

Installation# Quick Start (Recommended)

You can use the server without any installation:

{
  "mcpServers": {
    "things3": {
      "command": "npx",
      "args": ["things3-mcp@latest"],
      "env": {"THINGS3_AUTH_TOKEN": "your_auth_token_here"}
    }
  }
}
```\n\n### Install from npm
```bash
npm install -g things3-mcp

Then add to your MCP client configuration:

{
  "mcpServers": {
    "things3": {
      "command": "things3-mcp",
      "env": {"THINGS3_AUTH_TOKEN": "your_auth_token_here"}
    }
  }
}
```\n\n### Install from Source
```bash\n\n# Clone the repository
git clone https://github.com/urbanogardun/things3-mcp.git
cd things3-mcp\n\n# Install dependencies
npm install\n\n# Build the project
npm run build

Configuration# Environment Variables

For update operations (modify, complete, delete), you need to set your Things3 authorization token:

export THINGS3_AUTH_TOKEN="your_auth_token_here"

To find your authorization token:

1. Open Things3
2. Go to Settings → General
3. Click "Enable Things URLs"
4. Click "Manage"
5. Copy the authorization token value

You can also create a .env file (see `.env.example).