things3-mcp

urbanogardun/things3-mcp

3.3

If you are the rightful owner of things3-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Things3 MCP Server is a Model Context Protocol server that integrates with Things3 on macOS, enabling AI assistants and other MCP clients to manage tasks efficiently.

The Things3 MCP Server provides a robust integration with the Things3 application on macOS, allowing for comprehensive task management through a suite of 25 specialized tools. This server facilitates interaction with Things3, enabling the creation, reading, updating, and deletion of tasks, projects, and areas. It supports hierarchical tag management and bulk operations, ensuring efficient task handling. The server also features intelligent error correction, automatically resolving common issues such as date conflicts and missing titles. With performance optimizations like connection pooling and AppleScript enhancements, the server ensures smooth and efficient operations. It requires macOS, Node.js, and the Things3 app, with AppleScript access enabled for full functionality.

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
  • Error Correction: Automatic fixing of common issues (date conflicts, missing titles)

Usages

usage with Claude Desktop npx

{
  "mcpServers": {
    "things3": {
      "command": "npx",
      "args": ["things3-mcp@latest"],
      "env": {
        "THINGS3_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

usage with Claude Desktop global npm

{
  "mcpServers": {
    "things3": {
      "command": "things3-mcp",
      "env": {
        "THINGS3_AUTH_TOKEN": "your_auth_token_here"
      }
    }
  }
}

usage with Claude Desktop local installation

{
  "mcpServers": {
    "things3": {
      "command": "node",
      "args": ["/absolute/path/to/things3-mcp/dist/index.js"]
    }
  }
}

Tools

  1. todos_list

    List TODOs with flexible filtering options.

  2. todos_get

    Get detailed information about a specific TODO.

  3. todos_create

    Create a new TODO with full property support.

  4. projects_list

    List projects with optional filtering.

  5. tags_list

    List all tags with hierarchy information.