SupaThings-MCP

[](https://www.npmjs.com/package/supathings-mcp) [](LICENSE) [](https://nodejs.org)

SupaThings MCP is a Things 3 MCP server for macOS.

It was built to solve a practical gap: AI agents can write to Things via things:///, but they cannot reliably understand your real project structure from URL commands alone.

SupaThings combines SQLite-based reads with official URL-scheme writes, so agents can both understand and act safely.

• Quick Start
• What This MCP Server Does (and Why It Exists)
• Current Scope (v0.4.0)
• How It Works
• Things-Native Philosophy
• Recommended Workflows
• Available Tools
• Token and Context Efficiency
• Requirements
• Build and Smoke Tests
• Packaging and Release
• Project Structure
• Attribution
• Support
• License

npx -y supathings-mcp

npm install -g supathings-mcp

Alias also available:

things-mcp

npm install
npm run build
node dist/index.js

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

Codex:

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

Claude Code:

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

Ge