things-mcp 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b5dce71de1e5a5690e3acbf04a39844482fd77a225255e6c0f6ed6174c14746
-  data.tar.gz: 2ae46521ad48efabb5ea24351f9bae9fc36df2ea1017e0f5a3ff4ef1b7ca6362
+  metadata.gz: 66584b39e6d5286abeb4a75f08f029bab5c7c1b7b7f42129ee12986086fa7927
+  data.tar.gz: bb7603686e15d0dc366f746e263dbb99cebb00ce35377e8ae49fb7f468658dc0
 SHA512:
-  metadata.gz: cb4149f6a999b9928d25d889a8b0d48f998d76c07573588a6b1dfff94a86ccfa2a4ee75156093c9c22483d7822852cbb2559de0418b58217e229cfb8d2f21cf5
-  data.tar.gz: d919bf9e96b98c7b8e54d69067f8a7aec30d4e53a0f62398fb30c54eadaedce0c18a95c1e12b2878444600356496f4c45a9332a143b8542feb876f81f05be23d
+  metadata.gz: 5ff846805290fb8e7e628b8809855c2538852be5f0ea69766d176fa6065081ae93af010b2958c68bdc4ce5014f580375939701bf7964a1d915ea3d72d0d5f30e
+  data.tar.gz: 8450f45b5c44b9cf8a37762e48cb7c4fe2b64a6e409ebcd2603036726c49535ad862b9ded6796dc13788694562c10e1406ec7547c7364c1bfa1d91b61312b8e9

data/Gemfile

@@ -6,6 +6,7 @@ gemspec
 
 # Development dependencies
 group :development do
+  gem "debug"
   gem "rake"
   gem "rubocop-shopify", require: false
 end

data/README.md

@@ -1,6 +1,6 @@
 # Things 3 MCP Server (Ruby)
 
-A Model Context Protocol (MCP) server for Things 3, implemented in Ruby.
+A (clunky) Model Context Protocol (MCP) server for Things 3, implemented in Ruby.
 
 ## Features
 
@@ -16,19 +16,22 @@ A Model Context Protocol (MCP) server for Things 3, implemented in Ruby.
 2. **Ruby 3.2+** installed (required by the MCP gem dependency)
 3. **No authentication required** - the server reads from Things' local database
 
-> **Note for macOS users**: The system Ruby (typically 2.6.x) is too old. Install a modern Ruby version:
-> ```bash
-> # Using Homebrew (recommended)
-> brew install ruby
-> 
-> # Or using rbenv
-> brew install rbenv
-> rbenv install 3.4.1
-> rbenv global 3.4.1
-> ```
+**Note for macOS users**: The system Ruby is possibly too old. Install a modern Ruby.
 
 ## Installation
 
+### Option 1: Using the Released Gem (Recommended)
+
+1. Install the gem:
+
+```bash
+gem install things-mcp
+```
+
+2. The MCP server will be available as `things_mcp_server` in your PATH.
+
+### Option 2: From Source
+
 1. Clone this repository:
 
 ```bash
@@ -56,12 +59,6 @@ bin/test_connection
 THINGS_AUTH_TOKEN=your_token_here bin/test_connection
 ```
 
-3. **Via Rake:**
-
-```bash
-bundle exec rake test
-```
-
 The test script will:
 
 - ✓ Check if Things app is running
@@ -71,7 +68,15 @@ The test script will:
 - ✓ Verify the todo in the database
 - ✓ Test update operations by completing the test todo (if auth token provided)
 
-2. Run the MCP server:
+## Running the MCP Server
+
+### If Using the Gem
+
+```bash
+things_mcp_server
+```
+
+### If Using from Source
 
 ```bash
 bundle exec ruby bin/things_mcp_server
@@ -90,6 +95,20 @@ Add to your Claude Desktop configuration file:
 - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
 
+#### Using the Released Gem (Recommended)
+
+```json
+{
+  "mcpServers": {
+    "things": {
+      "command": "things_mcp_server"
+    }
+  }
+}
+```
+
+#### Using from Source
+
 ```json
 {
   "mcpServers": {
@@ -116,6 +135,23 @@ For `update-todo` and `update-project` operations, you need to provide a Things
 
 2. **Add the token to your configuration:**
 
+#### Using the Released Gem
+
+```json
+{
+  "mcpServers": {
+    "things": {
+      "command": "things_mcp_server",
+      "env": {
+        "THINGS_AUTH_TOKEN": "your_authorization_token_here"
+      }
+    }
+  }
+}
+```
+
+#### Using from Source
+
 ```json
 {
   "mcpServers": {
@@ -131,6 +167,8 @@ For `update-todo` and `update-project` operations, you need to provide a Things
 }
 ```
 
+**Note:** Replace `YOUR_USERNAME` with your actual macOS username. If you have trouble finding the exact database path, you can run `find ~/Library/Group\ Containers -name "main.sqlite" 2>/dev/null | grep Things` to locate it.
+
 ⚠️ **Security Note:** Keep your authorization token private. It allows full access to modify your Things data.
 
 ### Other MCP Clients
@@ -193,15 +231,18 @@ Once configured, you can use your MCP-compatible AI client to:
 - `add-project` - Create a new project in Things
 - `update-todo` - Update an existing todo ⚠️ _Requires auth token_
 - `update-project` - Update an existing project ⚠️ _Requires auth token_
+
+> **Note:** When adding tags to existing todos/projects, the tags must already exist in Things. The URL scheme will not create new tags automatically.
+
 - `show-item` - Show a specific item or list in Things
 - `search-items` - Search for items and open in Things
 
 ## Development
 
-Run tests:
+Run connection tests:
 
 ```bash
-bundle exec rake test
+bin/test_connection
 ```
 
 Run linter:
@@ -210,12 +251,6 @@ Run linter:
 bundle exec rake rubocop
 ```
 
-Run both tests and linter:
-
-```bash
-bundle exec rake
-```
-
 ## License
 
 MIT

data/bin/test_connection

@@ -1,8 +1,8 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "bundler/setup"
-require_relative "../lib/things_mcp"
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+require "things_mcp"
 
 puts "Testing Things MCP Ruby Server"
 puts "=" * 40
@@ -71,7 +71,8 @@ begin
         inbox_todos = ThingsMcp::Database.get_inbox
         test_todo = inbox_todos.find { |t| t[:title] == test_todo_title }
         break if test_todo
-        sleep(1) if i < 2  # Don't sleep after the last attempt
+
+        sleep(1) if i < 2 # Don't sleep after the last attempt
       end
 
       if test_todo
@@ -81,6 +82,7 @@ begin
           "completed" => true,
         })
 
+        # rubocop:disable Metrics/BlockNesting
         if complete_result[:success]
           puts "✅ Update operations working - test todo completed and cleaned up"
         else
@@ -88,6 +90,7 @@ begin
           puts "  You may need to manually complete: '#{test_todo_title}'"
           @test_failed = true
         end
+        # rubocop:enable Metrics/BlockNesting
       else
         puts "❌ Could not find test todo in database after 3 attempts"
         puts "  Database sync delay longer than expected - please manually complete: '#{test_todo_title}'"

data/bin/things_mcp_server

@@ -1,8 +1,9 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "bundler/setup"
-require_relative "../lib/things_mcp/server"
+lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "things_mcp/server"
 
 # Run the MCP server
 ThingsMcp::Server.new.run

data/lib/things_mcp/database.rb

@@ -11,31 +11,7 @@ module ThingsMcp
   # This class provides read-only access to the Things 3 database, enabling retrieval of todos, projects, areas, and
   # tags. It handles dynamic database path resolution and provides formatted data structures.
   class Database
-
     class << self
-      def find_database_path
-        group_containers_dir = "#{Dir.home}/Library/Group Containers"
-        
-        # Find Things-specific directories to avoid permission issues
-        things_dirs = Dir.glob("#{group_containers_dir}/*").select do |dir|
-          File.basename(dir).include?("culturedcode.ThingsMac")
-        end
-
-        things_dirs.each do |things_dir|
-          # Try new format first (Things 3.15.16+)
-          new_pattern = "#{things_dir}/ThingsData-*/Things Database.thingsdatabase/main.sqlite"
-          matches = Dir.glob(new_pattern)
-          return matches.first unless matches.empty?
-
-          # Fall back to old format
-          old_pattern = "#{things_dir}/Things Database.thingsdatabase/main.sqlite"
-          return old_pattern if File.exist?(old_pattern)
-        end
-
-        # Check environment variable
-        ENV["THINGSDB"] if ENV["THINGSDB"] && File.exist?(ENV["THINGSDB"])
-      end
-
       def database_path
         @database_path ||= find_database_path
       end
@@ -47,15 +23,6 @@ module ThingsMcp
       def with_database(&block)
         db_path = database_path
         unless db_path
-          $stderr.puts "DEBUG: Database path search failed"
-          $stderr.puts "DEBUG: Home directory: #{Dir.home}"
-          $stderr.puts "DEBUG: Group Containers exists: #{File.exist?("#{Dir.home}/Library/Group Containers")}"
-          if File.exist?("#{Dir.home}/Library/Group Containers")
-            containers = Dir.glob("#{Dir.home}/Library/Group Containers/*")
-            $stderr.puts "DEBUG: Found containers: #{containers.size}"
-            things_containers = containers.select { |c| File.basename(c).include?("culturedcode") }
-            $stderr.puts "DEBUG: Things containers: #{things_containers}"
-          end
           raise "Things database not found. Please ensure Things 3 is installed and has been launched at least once."
         end
 
@@ -335,9 +302,48 @@ module ThingsMcp
 
       private
 
+      def find_database_path
+        # Use actual user's home directory, not the process owner's
+        actual_home = ENV["HOME"] || Dir.home
+        # If running as root, try to find the real user's home directory
+        if actual_home == "/var/root" && ENV["SUDO_USER"]
+          actual_home = "/Users/#{ENV["SUDO_USER"]}"
+        elsif actual_home == "/var/root"
+          # Fallback: look for the most recent user directory
+          user_dirs = Dir.glob("/Users/*").select { |d| File.directory?(d) && !File.basename(d).start_with?(".") }
+          actual_home = user_dirs.max_by { |d| File.mtime(d) } if user_dirs.any?
+        end
+
+        group_containers_dir = "#{actual_home}/Library/Group Containers"
+
+        # Find Things-specific directories to avoid permission issues
+        things_dirs = Dir.glob("#{group_containers_dir}/*").select do |dir|
+          File.basename(dir).include?("culturedcode.ThingsMac")
+        end
+
+        things_dirs.each do |things_dir|
+          # First try to find the current database (not in Backups folder)
+          current_pattern = "#{things_dir}/*/Things Database.thingsdatabase/main.sqlite"
+          current_matches = Dir.glob(current_pattern).reject { |path| path.include?("/Backups/") }
+
+          unless current_matches.empty?
+            return current_matches.first
+          end
+
+          # Fallback: look for any main.sqlite but exclude backups
+          fallback_pattern = "#{things_dir}/*/*/main.sqlite"
+          fallback_matches = Dir.glob(fallback_pattern).reject { |path| path.include?("/Backups/") }
+
+          unless fallback_matches.empty?
+            return fallback_matches.first
+          end
+        end
+
+        nil
+      end
+
       def todo_columns
-        "uuid, title, notes, status, project, area, start, startDate, " \
-          "deadline, creationDate, userModificationDate"
+        "uuid, title, notes, status, project, area, start, startDate, deadline, creationDate, userModificationDate"
       end
 
       def build_todo_query(project_uuid: nil)

data/lib/things_mcp/formatters.rb

@@ -147,6 +147,5 @@ module ThingsMcp
 
       lines.join("\n")
     end
-
   end
 end

data/lib/things_mcp/handlers.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 require "json"
-require_relative "database"
-require_relative "url_scheme"
-require_relative "formatters"
+require "things_mcp/database"
+require "things_mcp/url_scheme"
+require "things_mcp/formatters"
 
 module ThingsMcp
   # Tool call handlers for MCP server
@@ -206,8 +206,8 @@ module ThingsMcp
 
     def handle_update_todo(args)
       unless ENV["THINGS_AUTH_TOKEN"]
-        return "❌ Update operations require authentication. Please set THINGS_AUTH_TOKEN environment variable. " +
-               "See README for setup instructions."
+        return "❌ Update operations require authentication. Please set THINGS_AUTH_TOKEN environment variable. " \
+          "See README for setup instructions."
       end
 
       result = UrlScheme.update_todo(args)
@@ -221,8 +221,8 @@ module ThingsMcp
 
     def handle_update_project(args)
       unless ENV["THINGS_AUTH_TOKEN"]
-        return "❌ Update operations require authentication. Please set THINGS_AUTH_TOKEN environment variable. " +
-               "See README for setup instructions."
+        return "❌ Update operations require authentication. Please set THINGS_AUTH_TOKEN environment variable. " \
+          "See README for setup instructions."
       end
 
       result = UrlScheme.update_project(args)

data/lib/things_mcp/server.rb

@@ -3,10 +3,10 @@
 require "mcp"
 require "mcp/transports/stdio"
 require "logger"
-require_relative "tools"
-require_relative "handlers"
-require_relative "database"
-require_relative "url_scheme"
+require "things_mcp/tools"
+require "things_mcp/handlers"
+require "things_mcp/database"
+require "things_mcp/url_scheme"
 
 module ThingsMcp
   # MCP server implementation for Things 3 integration
@@ -27,7 +27,7 @@ module ThingsMcp
       @server = MCP::Server.new(
         name: "things",
         version: "0.1.0",
-        tools: @tool_classes
+        tools: @tool_classes,
       )
     rescue => e
       $stderr.puts "ERROR during initialization: #{e.class}: #{e.message}"
@@ -62,12 +62,12 @@ module ThingsMcp
     def check_ruby_version
       required_version = Gem::Version.new("3.2.0")
       current_version = Gem::Version.new(RUBY_VERSION)
-      
+
       return if current_version >= required_version
 
       $stderr.puts "❌ Ruby #{RUBY_VERSION} is too old! This server requires Ruby 3.2+"
       $stderr.flush
-      exit 1
+      exit(1)
     end
 
     def create_tool_classes
@@ -107,12 +107,15 @@ module ThingsMcp
             },
           ])
         rescue => e
-          MCP::Tool::Response.new([
-            {
-              type: "text",
-              text: "Error: #{e.message}",
-            },
-          ])
+          # Log the full error to stderr for debugging
+          $stderr.puts "ERROR in tool #{name}: #{e.class}: #{e.message}"
+          $stderr.puts "Arguments: #{string_arguments.inspect}"
+          $stderr.puts "Backtrace:"
+          e.backtrace.each { |line| $stderr.puts "  #{line}" }
+          $stderr.flush
+
+          # Also raise the error so MCP can handle it properly
+          raise e
         end
       end
     end

data/lib/things_mcp/url_scheme.rb

@@ -112,9 +112,8 @@ module ThingsMcp
       # Build query string and convert + to %20 for spaces
       query_string = URI.encode_www_form(params)
       query_string = query_string.gsub("+", "%20") unless query_string.empty?
-      
-      full_url = query_string.empty? ? base_url : "#{base_url}?#{query_string}"
 
+      full_url = query_string.empty? ? base_url : "#{base_url}?#{query_string}"
 
       # Ensure Things is running
       unless things_running?
@@ -151,6 +150,5 @@ module ThingsMcp
 
       auth_required_operations.any? { |op| url.start_with?(op) }
     end
-
   end
 end

data/lib/things_mcp/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module ThingsMcp
+  VERSION = "0.1.2"
+end

data/lib/things_mcp.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 require "mcp"
-require_relative "things_mcp/server"
-require_relative "things_mcp/database"
-require_relative "things_mcp/handlers"
-require_relative "things_mcp/tools"
-require_relative "things_mcp/url_scheme"
-require_relative "things_mcp/formatters"
+require "things_mcp/server"
+require "things_mcp/database"
+require "things_mcp/handlers"
+require "things_mcp/tools"
+require "things_mcp/url_scheme"
+require "things_mcp/formatters"
 
 # ThingsMcp provides a Model Context Protocol (MCP) server for Things 3
 #

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: things-mcp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Hakan Ensari
@@ -10,52 +10,51 @@ cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: mcp
+  name: logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '1.4'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '1.4'
 - !ruby/object:Gem::Dependency
-  name: sqlite3
+  name: mcp
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '0.1'
 - !ruby/object:Gem::Dependency
-  name: logger
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.4'
+        version: '2.0'
 description: A Model Context Protocol (MCP) server for Things 3, implemented in Ruby
 email:
 - hakanensari@gmail.com
 executables:
-- test_connection
 - things_mcp_server
 extensions: []
 extra_rdoc_files: []
@@ -73,6 +72,7 @@ files:
 - lib/things_mcp/server.rb
 - lib/things_mcp/tools.rb
 - lib/things_mcp/url_scheme.rb
+- lib/things_mcp/version.rb
 homepage: https://github.com/hakanensari/things-mcp-ruby
 licenses:
 - MIT