things-mcp 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e31d578d8f6cb134b0d9b326d9178bc2b65c5eb83ceae17da565f033361877da
-  data.tar.gz: 251493afb608cc788e59d2fc9ec383fbbfc6abd47ee1b6f252f9cc317450e87f
+  metadata.gz: c04d398fe0ae4d889f3b1283f170b7ea16d89d3aadb15c0729f02224051fb40c
+  data.tar.gz: 63edc670dfefbf746f0397a3a41e95e81ae977237421057e89564b4b77ce998b
 SHA512:
-  metadata.gz: 68faf189bd64f1e6e11eb4e68099abc9b65f64ffbffb0b0057efff92f019de56e169b38f8b5fd32dc40f0735435a62a3a2a6cfe97a1c480da1009c40c151a8b3
-  data.tar.gz: 25e5e7bb0e01c27265af90f70174da40d320d1bc89193e31f5a0965d9fa970422d2edbc85996579e0e50a196ad6aa1c41fd6f99f7c310637d6a90f253ff83d60
+  metadata.gz: 749a56ffef198d8bfabf98212faa51e8d47f8b79280a09899910a49938ea20391ebe08e8a5387ef593ec3095bea9aa7d138ca7294058d3b995ed3f4385fc0ee0
+  data.tar.gz: 570aeb516c134b4de385a25b672677976879dcccab000be09ba697568de5ff03864ea328a695ba03212c49b28352f5be1e820402f2ed172483aba476df9a1eca

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

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,6 +11,10 @@ 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
+    # Things date encoding constants
+    UNITS_PER_DAY = 128.0
+    EPOCH = Date.new(-814, 4, 1)
+
     class << self
       def database_path
         @database_path ||= find_database_path
@@ -62,7 +66,24 @@ module ThingsMcp
       end
 
       def get_today
-        get_todos_by_start(1)
+        # Get todos scheduled for today or overdue (startDate <= today's value)
+        today_value = (Date.today - EPOCH) * UNITS_PER_DAY
+
+        with_database do |db|
+          query = <<~SQL
+            SELECT #{todo_columns}
+            FROM TMTask
+            WHERE type = 0
+              AND status = 0
+              AND trashed = 0
+              AND startDate IS NOT NULL
+              AND startDate <= #{today_value.to_i}
+            ORDER BY "index"
+          SQL
+
+          results = db.execute(query).map { |row| format_todo(row) }
+          add_checklist_items_and_tags(db, results)
+        end
       end
 
       def get_upcoming
@@ -78,21 +99,56 @@ module ThingsMcp
             ORDER BY COALESCE(startDate, deadline)
           SQL
 
-          db.execute(query).map { |row| format_todo(row) }
+          results = db.execute(query).map { |row| format_todo(row) }
+          add_checklist_items_and_tags(db, results)
         end
       end
 
       def get_anytime
-        get_todos_by_start(2).reject { |t| t[:start_date] || t[:deadline] }
+        with_database do |db|
+          query = <<~SQL
+            SELECT #{todo_columns}
+            FROM TMTask
+            WHERE type = 0
+              AND status = 0
+              AND trashed = 0
+              AND start = 1
+            ORDER BY "index"
+          SQL
+
+          results = db.execute(query).map { |row| format_todo(row) }
+          add_checklist_items_and_tags(db, results)
+        end
       end
 
       def get_someday
-        get_todos_by_start(3)
+        # Get todos in someday: start=2 with no dates
+        # FIXME: Recurring items (like "Update mileage log") appear here when they should
+        # appear in Today or Scheduled based on their next occurrence. Things likely uses
+        # additional metadata to track recurring patterns that we haven't implemented.
+        with_database do |db|
+          query = <<~SQL
+            SELECT #{todo_columns}
+            FROM TMTask
+            WHERE type = 0
+              AND status = 0
+              AND trashed = 0
+              AND start = 2
+              AND startDate IS NULL
+              AND deadline IS NULL
+            ORDER BY "index"
+          SQL
+
+          results = db.execute(query).map { |row| format_todo(row) }
+          add_checklist_items_and_tags(db, results)
+        end
       end
 
       def get_logbook(period: "7d", limit: 50)
         days = parse_period(period)
         cutoff = Date.today - days
+        # stopDate is a REAL column with Unix timestamp
+        cutoff_timestamp = cutoff.to_time.to_i
 
         with_database do |db|
           query = <<~SQL
@@ -101,7 +157,7 @@ module ThingsMcp
             WHERE type = 0
               AND status IN (3, 2)
               AND trashed = 0
-              AND stopDate >= julianday('#{cutoff}')
+              AND stopDate >= #{cutoff_timestamp}
             ORDER BY stopDate DESC
             LIMIT #{limit}
           SQL
@@ -247,11 +303,17 @@ module ThingsMcp
 
           # Date filters
           if filters[:start_date]
-            conditions << "startDate >= julianday('#{filters[:start_date]}')"
+            # startDate is INTEGER column with NSDate seconds
+            nsdate_epoch = Time.new(2001, 1, 1, 0, 0, 0, "+00:00")
+            start_timestamp = (Date.parse(filters[:start_date]).to_time - nsdate_epoch).to_i
+            conditions << "startDate >= #{start_timestamp}"
           end
 
           if filters[:deadline]
-            conditions << "deadline <= julianday('#{filters[:deadline]}')"
+            # deadline is INTEGER column with NSDate seconds
+            nsdate_epoch = Time.new(2001, 1, 1, 0, 0, 0, "+00:00")
+            deadline_timestamp = (Date.parse(filters[:deadline]).to_time - nsdate_epoch).to_i
+            conditions << "deadline <= #{deadline_timestamp}"
           end
 
           # Tag filter
@@ -285,6 +347,8 @@ module ThingsMcp
       def get_recent(period)
         days = parse_period(period)
         cutoff = Date.today - days
+        # creationDate is a REAL column with Unix timestamp
+        cutoff_timestamp = cutoff.to_time.to_i
 
         with_database do |db|
           query = <<~SQL
@@ -292,7 +356,7 @@ module ThingsMcp
             FROM TMTask
             WHERE type = 0
               AND trashed = 0
-              AND creationDate >= julianday('#{cutoff}')
+              AND creationDate >= #{cutoff_timestamp}
             ORDER BY creationDate DESC
           SQL
 
@@ -303,7 +367,18 @@ module ThingsMcp
       private
 
       def find_database_path
-        group_containers_dir = "#{Dir.home}/Library/Group Containers"
+        # 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|
@@ -311,11 +386,24 @@ module ThingsMcp
         end
 
         things_dirs.each do |things_dir|
-          pattern = "#{things_dir}/*/*/main.sqlite"
-          matches = Dir.glob(pattern)
+          # 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
 
-          return matches.first unless matches.empty?
+          # 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
@@ -389,10 +477,10 @@ module ThingsMcp
           area: row["area"],
           tags: [],  # Tags will be populated separately
           when: format_when(row["start"]),
-          start_date: julian_to_date(row["startDate"]),
-          deadline: julian_to_date(row["deadline"]),
-          created: julian_to_date(row["creationDate"]),
-          modified: julian_to_date(row["userModificationDate"]),
+          start_date: things_date_to_date(row["startDate"]),
+          deadline: things_date_to_date(row["deadline"]),
+          created: unix_timestamp_to_date(row["creationDate"]),
+          modified: unix_timestamp_to_date(row["userModificationDate"]),
         }
       end
 
@@ -405,10 +493,10 @@ module ThingsMcp
           area: row["area"],
           tags: [],  # Tags will be populated separately for projects too
           when: format_when(row["start"]),
-          start_date: julian_to_date(row["startDate"]),
-          deadline: julian_to_date(row["deadline"]),
-          created: julian_to_date(row["creationDate"]),
-          modified: julian_to_date(row["userModificationDate"]),
+          start_date: things_date_to_date(row["startDate"]),
+          deadline: things_date_to_date(row["deadline"]),
+          created: unix_timestamp_to_date(row["creationDate"]),
+          modified: unix_timestamp_to_date(row["userModificationDate"]),
         }
       end
 
@@ -446,11 +534,20 @@ module ThingsMcp
         end
       end
 
-      def julian_to_date(julian_days)
-        return unless julian_days
+      def things_date_to_date(value)
+        return unless value
 
-        # SQLite Julian day starts from noon on November 24, 4714 BC
-        Date.jd(julian_days.to_i + 2400001).to_s
+        # Things uses custom date encoding: 128 units = 1 day (11.25 minutes per unit)
+        # Epoch calculated from reverse engineering known date values
+        days = value / UNITS_PER_DAY
+        (EPOCH + days).to_s
+      end
+
+      def unix_timestamp_to_date(value)
+        return unless value
+
+        # REAL columns (creationDate, userModificationDate): Unix timestamps (seconds since 1970-01-01)
+        Time.at(value.to_f).to_date.to_s
       end
 
       def parse_period(period)
@@ -477,6 +574,15 @@ module ThingsMcp
         # If decoding fails, return original title
         title
       end
+
+      # Helper method to consistently add checklist items and tags to todos
+      def add_checklist_items_and_tags(db, todos)
+        todos.each do |todo|
+          todo[:checklist_items] = get_checklist_items(db, todo[:uuid])
+          todo[:tags] = get_tags_for_task(db, todo[:uuid])
+        end
+        todos
+      end
     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

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
@@ -95,7 +95,7 @@ module ThingsMcp
           required: tool_def[:inputSchema][:required],
         )
 
-        define_singleton_method(:call) do |_server_context:, **arguments|
+        define_singleton_method(:call) do |server_context:, **arguments|
           # Convert symbol keys to string keys for consistent access
           string_arguments = arguments.transform_keys(&:to_s)
           result = ThingsMcp::Handlers.handle_tool_call(name, string_arguments)
@@ -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/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ThingsMcp
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 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.1
+  version: 0.1.3
 platform: ruby
 authors:
 - Hakan Ensari