SupaThings-MCP

Overview

SupaThings-MCP is a specialized MCP server that bridges the gap between AI agents and Things 3 task management software on macOS. It uses SQLite to read the local Things database for structural context and official things:/// URL schemes for safe writes, enabling AI agents to both understand and act on task management data. The server provides 37 tools covering data inspection, semantic planning, and task management workflows, with a focus on efficiency and Things-native philosophy.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• app-status

  Check the status of the Things app

  Try:Is Things app running?Try:Check Things app status
• get-projects

  Retrieve all projects from Things

  Try:List all my projectsTry:Show me all projects in Things
• get-project-structure

  Get the structure of a specific project including headings

  Try:Show me the structure of my 'Work' projectTry:Get structure of 'Home Renovation' project
• suggest-headings

  Suggest appropriate headings for a project based on its content

  Try:Suggest headings for my new book projectTry:What headings should I add to my 'Fitness' project?
• create-project-with-headings

  Create a new project with specified headings

  Try:Create a 'Marketing Plan' project with headings for Research and StrategyTry:Make a 'Vacation Planning' project with itinerary and packing headings
• add-todo

  Add a new todo item to Things

  Try:Add 'Buy groceries' to my shopping listTry:Create a todo to finish the report by Friday
• summarize-project

  Generate a summary of a project's contents and progress

  Try:Summarize my current 'Website Redesign' projectTry:Give me a quick summary of my 'Q4 Planning' project
• suggest-task-placement

  Suggest the best heading to place a task within a project

  Try:Where should I place 'Design logo' in my project?Try:Suggest placement for 'Call vendor' in my project
• search-todos

  Search for todo items matching specific criteria

  Try:Find all todos related to 'billing'Try:Search for incomplete tasks about taxes
• update-todo

  Update an existing todo item in Things

  Try:Mark 'Prepare presentation' as completedTry:Change the due date of 'Submit report' to Monday
• show-quick-entry

  Show Things' quick entry window

  Try:Open Things quick entryTry:Show me the quick entry dialog
• log-completed

  Log completed tasks to Things logbook

  Try:Log my completed workoutTry:Record that I finished reading the book

Comparable tools

Installation

npx -y supathings-mcp

npm install -g supathings-mcp

{
  "mcpServers": {
    "supathings": {
      "command": "npx",
      "args": ["-y", "supathings-mcp"]
    }
  }
}

codex mcp add supathings -- npx -y supathings-mcp

claude mcp add --transport stdio supathings -- npx -y supathings-mcp

gemini mcp add -s user supathings npx -y supathings-mcp

FAQ

What permissions are required for SupaThings-MCP?

The server requires macOS, Things 3 installed locally, Node.js 22+, and npm 10+. Optional AppleScript actions require Apple Events permission.

How does SupaThings-MCP handle recurring tasks in Things?

Recurring template rows are intentionally excluded from read queries to maintain efficiency and avoid complexity in the API.

Compare SupaThings-MCP with