SupaThings MCP
SupaThings MCP is a macOS server that enables AI agents to read and manage Things 3 data by combining SQLite-based queries with official URL-scheme commands. It provides over 30 tools for project structural analysis and task placement, allowing agent
What is SupaThings MCP?
SupaThings MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to supathings mcp is a macos server that enables ai agents to read and manage things 3 data by combining sqlite-based queries with official url-scheme commands. it provides over 30 tools for project stru...
SupaThings MCP is a macOS server that enables AI agents to read and manage Things 3 data by combining SQLite-based queries with official URL-scheme commands. It provides over 30 tools for project structural analysis and task placement, allowing agent
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- SupaThings MCP is a macOS server that enables AI agents to r
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx supathings-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use SupaThings MCP
SupaThings MCP is a macOS-only MCP server that bridges the gap between AI agents and the Things 3 task manager by combining direct SQLite reads from the local Things database with official things:/// URL scheme writes. It exposes 37 tools covering read access to areas, projects, headings, todos, tags, and the inbox, as well as semantic planning tools for heading inference and task placement, plus write tools for creating and updating tasks and projects. This makes it possible for agents to truly understand your project structure and place tasks intelligently rather than blindly appending to a list.
Prerequisites
- macOS with Things 3 installed and at least one project created
- Node.js 22 or higher (the package requires node >= 22)
- An MCP-compatible client such as Claude Desktop, Claude Code, Codex, or Gemini CLI
- npx available in your terminal (comes with Node.js)
Verify Things 3 is installed and running
SupaThings reads the local Things SQLite database and sends commands via the things:/// URL scheme. Things 3 must be installed and have been opened at least once so the database file exists on disk.
open -a 'Things3'Run the server with npx
Launch SupaThings MCP without a global install using npx. The -y flag auto-confirms the package download.
npx -y supathings-mcpAdd to your MCP client
Register the server in your MCP client configuration. The server runs over stdio so no port is needed.
Add with Claude Code CLI
If you use Claude Code, you can register SupaThings in one command without editing config files manually.
claude mcp add --transport stdio supathings -- npx -y supathings-mcpTest by listing your projects
Ask your AI client to call the get-projects tool to confirm the server can read your Things database.
SupaThings MCP Examples
Client configuration
Add this to your claude_desktop_config.json to register SupaThings MCP with Claude Desktop.
{
"mcpServers": {
"supathings": {
"command": "npx",
"args": ["-y", "supathings-mcp"]
}
}
}Prompts to try
Ask your AI agent to analyze your Things 3 workspace and help manage tasks using the 37 available tools.
- "Show me all my Things 3 projects and their headings."
- "Suggest headings for my new 'Website Redesign' project in Things 3."
- "Add a task called 'Write unit tests' under the correct heading in my API project."
- "What tasks are in my Things inbox today?"
- "Summarize the structure of my 'Q3 Goals' project in Things 3."Troubleshooting SupaThings MCP
Server starts but get-projects returns empty results
Things 3 must be installed and have been opened at least once so its SQLite database exists. Check that Things 3 is not in a sandboxed location by opening it, creating a test project, then retrying.
AppleScript tools (show-quick-entry, log-completed, empty-trash) fail with permission errors
Grant your terminal app (or the app running the MCP client) Automation access in System Settings → Privacy & Security → Automation. The server fails these gracefully if Apple Events are unavailable.
Node.js version error on startup
SupaThings requires Node.js 22 or higher. Run node --version to check and upgrade with nvm use 22 or by downloading Node.js 22 from nodejs.org.
Frequently Asked Questions about SupaThings MCP
What is SupaThings MCP?
SupaThings MCP is a Model Context Protocol (MCP) server that supathings mcp is a macos server that enables ai agents to read and manage things 3 data by combining sqlite-based queries with official url-scheme commands. it provides over 30 tools for project structural analysis and task placement, allowing agent It connects AI assistants to external tools and data sources through a standardized interface.
How do I install SupaThings MCP?
Follow the installation instructions on the SupaThings MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with SupaThings MCP?
SupaThings MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is SupaThings MCP free to use?
Yes, SupaThings MCP is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
SupaThings MCP Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to SupaThings MCP? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up SupaThings MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use SupaThings MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.