{"repo":"soycanopa/SupaThings-MCP","free":true,"listed":false,"github":"https://github.com/soycanopa/SupaThings-MCP","clone":"git clone https://github.com/soycanopa/SupaThings-MCP.git","description":"Things 3 MCP server for macOS with SQLite reads, official things:/// URL writes, and semantic planning tools for AI agents.","language":"JavaScript","stars":23,"topics":["mcp","model-context-protocol","things","things3","macos","productivity","sqlite","ai-agent","typescript"],"license":null,"category":"mcp-servers","readme_excerpt":"SupaThings MCP 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. Table of Contents - 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 Quick Start 1) Run with npx (no install) 2) Global install from npm Alias also available: 3) Build from source 4) MCP config example 5) Configure MCP in your client (copy/paste) Codex: Claude Code: Gemini CLI: What This MCP Server Does (and Why It Exists) MCP servers expose tools over a standard protocol so AI clients can call them programmatically. In Things, there are two realities: - The things:/// URL scheme is excellent for creating/updating/navigating items. - URL commands alone do not expose full structural context (project hierarchy, headings, checklist relationships, planning summaries). SupaThings was built to bridge that split. Technical approach: - Read path: query local Things SQLite data for structure and context. - Write path: execute official things:/// URL actions for safe int","default_branch":null,"files":null,"tree":[],"storefront":"/r/soycanopa","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/soycanopa/SupaThings-MCP/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}