{"id":"soycanopa-supathings-mcp","name":"SupaThings-MCP","homepage":null,"repo_url":"https://github.com/soycanopa/SupaThings-MCP","category":"automation","subcategories":[],"tags":["mcp","things3","macos","sqlite","productivity","ai-agent","nodejs"],"what_it_does":"SupaThings MCP is a macOS-focused Model Context Protocol (MCP) server that reads structured Things 3 data from the local Things SQLite database, writes/updates/navigates using the official Things URL scheme (things:///), and provides semantic “planning” helpers (heading inference/validation, project summaries, and task placement suggestions). It can optionally perform lightweight AppleScript actions when Apple Events are available.","use_cases":["Let AI agents understand Things 3 project structure (areas, projects, headings, todos, tags, schedules) with compact/structured context.","Enable AI agents to safely create and update Things items by delegating mutations to official things:/// URL actions.","Support agent planning workflows: suggest or validate headings, summarize projects, and propose task placement.","Assist with search and filtering across Things items (including logbook, trash, tag-based searches).","Use MCP clients (Codex/Claude Code/Gemini CLI) over stdio to call Things tools programmatically."],"not_for":["Server-side/hosted deployments that cannot access a local Things installation and its SQLite database.","Cross-platform usage (designed for macOS).","Authentication-requiring, multi-tenant scenarios where per-user access controls are needed.","Use cases needing an HTTP REST/SDK interface rather than MCP stdio integration."],"best_when":"You run on macOS with Things 3 installed and want MCP-based agent tooling that combines rich local reads with official Things URL-scheme writes.","avoid_when":"You need a web API, want cloud hosting, or require strong multi-user authentication/authorization controls beyond local machine permissions.","alternatives":["Other Things MCP servers (e.g., repositories referenced by the README: jimfilippou/things-mcp, hald/things-mcp).","Direct use of Things URL scheme (things:///) without structured reads.","Community/third-party integrations that parse Things exports or use different local data access methods.","Build a custom MCP wrapper around your own Things SQLite access + URL scheme write adapter."],"af_score":63.2,"security_score":49.2,"reliability_score":36.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:39:49.109352+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Local stdio transport for MCP client (no explicit auth described)"],"oauth":false,"scopes":false,"notes":"No authentication/authorization mechanism is documented. The server appears intended for local use by whatever MCP client runs it on the user’s machine; effective access control is likely the OS user context and Things local installation permissions."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing model is provided in the supplied content (npm presence implied)."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":63.2,"security_score":49.2,"reliability_score":36.2,"mcp_server_quality":78.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":"README mentions graceful failure when Apple Events are unavailable, and describes smoke tests, but does not show tool-by-tool error codes/messages or concrete error payload examples.","auth_complexity":95.0,"rate_limit_clarity":10.0,"tls_enforcement":100.0,"auth_strength":20.0,"scope_granularity":10.0,"dependency_hygiene":55.0,"secret_handling":70.0,"security_notes":"Designed for local stdio MCP usage; no authentication or scope model is described, so authorization likely relies on OS/user and local Things permissions. Tool actions include writes via official things:/// URL scheme, which is safer than arbitrary mutations, but agents still need careful input validation to avoid unintended item changes. README does not describe logging/secret-handling or data minimization beyond token efficiency; dependency hygiene cannot be verified from provided content.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":45.0,"error_recovery":45.0,"idempotency_support":"false","idempotency_notes":"Write tools are described (add/update/move/navigation), but no idempotency guarantees or client guidance are documented.","pagination_style":"limit-based lists/search","retry_guidance_documented":false,"known_agent_gotchas":["Requires macOS + local Things 3 installation and access to local SQLite data.","AppleScript actions depend on Apple Events permissions; when unavailable, those tools fail gracefully (agent should not rely on them).","Recurring template rows are excluded from read queries (agent may not see them).","Adding missing headings to existing projects is constrained by Things capabilities (agent should validate/plan around this)."]}}