mcpeasy 0.1.0 → 0.3.0

data/lib/utilities/slack/service.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "slack-ruby-client"
+require "mcpeasy/config"
+
+module Slack
+  class Service
+    def initialize
+      ensure_env!
+      @client = ::Slack::Web::Client.new(
+        token: Mcpeasy::Config.slack_bot_token,
+        timeout: 10, # 10 second timeout
+        open_timeout: 5 # 5 second connection timeout
+      )
+    end
+
+    def post_message(channel:, text:, username: nil, thread_ts: nil)
+      # Clean up parameters
+      clean_channel = channel.to_s.sub(/^#/, "").strip
+      clean_text = text.to_s.strip
+
+      # Validate inputs
+      raise "Channel cannot be empty" if clean_channel.empty?
+      raise "Text cannot be empty" if clean_text.empty?
+
+      # Build request parameters
+      params = {
+        channel: clean_channel,
+        text: clean_text
+      }
+      params[:username] = username if username && !username.to_s.strip.empty?
+      params[:thread_ts] = thread_ts if thread_ts && !thread_ts.to_s.strip.empty?
+
+      # Retry logic for reliability
+      max_retries = 3
+      retry_count = 0
+
+      begin
+        response = @client.chat_postMessage(params)
+
+        if response["ok"]
+          response
+        else
+          raise "Failed to post message: #{response["error"]} (#{response.inspect})"
+        end
+      rescue ::Slack::Web::Api::Errors::TooManyRequestsError => e
+        retry_count += 1
+        if retry_count <= max_retries
+          sleep_time = e.retry_after || 1
+          sleep(sleep_time)
+          retry
+        else
+          raise "Slack API Error: #{e.message}"
+        end
+      rescue ::Slack::Web::Api::Errors::SlackError => e
+        retry_count += 1
+        if retry_count <= max_retries && retryable_error?(e)
+          sleep(0.5 * retry_count) # Exponential backoff
+          retry
+        else
+          raise "Slack API Error: #{e.message}"
+        end
+      rescue => e
+        Mcpeasy::Config.ensure_config_dirs
+        File.write(Mcpeasy::Config.log_file_path("slack", "error"), "#{Time.now}: Slack::Service error: #{e.class}: #{e.message}\n#{e.backtrace.join("\n")}\n", mode: "a")
+        raise e
+      end
+    end
+
+    def list_channels(limit: 100, cursor: nil, exclude_archived: true)
+      params = {
+        types: "public_channel,private_channel",
+        limit: [limit.to_i, 1000].min,
+        exclude_archived: exclude_archived
+      }
+      params[:cursor] = cursor if cursor && !cursor.to_s.strip.empty?
+
+      response = @client.conversations_list(params)
+
+      if response["ok"]
+        channels = response["channels"].to_a.map do |channel|
+          {
+            name: channel["name"],
+            id: channel["id"]
+          }
+        end
+
+        {
+          channels: channels,
+          has_more: response.dig("response_metadata", "next_cursor") ? true : false,
+          next_cursor: response.dig("response_metadata", "next_cursor")
+        }
+      else
+        raise "Failed to list channels: #{response["error"]}"
+      end
+    rescue ::Slack::Web::Api::Errors::SlackError => e
+      raise "Slack API Error: #{e.message}"
+    end
+
+    def test_connection
+      response = @client.auth_test
+
+      if response["ok"]
+        response
+      else
+        raise "Authentication failed: #{response["error"]}"
+      end
+    rescue ::Slack::Web::Api::Errors::SlackError => e
+      raise "Slack API Error: #{e.message}"
+    end
+
+    def tool_definitions
+    end
+
+    private
+
+    def retryable_error?(error)
+      # Network-related errors that might be temporary
+      error.is_a?(::Slack::Web::Api::Errors::TimeoutError) ||
+        error.is_a?(::Slack::Web::Api::Errors::UnavailableError) ||
+        (error.respond_to?(:message) && error.message.include?("timeout"))
+    end
+
+    def ensure_env!
+      unless Mcpeasy::Config.slack_bot_token
+        raise <<~ERROR
+          Slack bot token is not configured!
+          Please run: mcp set slack_bot_token YOUR_TOKEN
+        ERROR
+      end
+    end
+  end
+end

data/mcpeasy.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.email = ["joel@joelhelbling.com"]
 
   spec.summary = "MCP servers made easy"
-  spec.description = "mcpeasy, LM squeezy - Easy-to-use MCP servers for Google Calendar, Google Drive, Google Meet, and Slack"
+  spec.description = "mcpeasy, LM squeezy - Easy-to-use MCP servers for Gmail, Google Calendar, Google Drive, Google Meet, and Slack"
   spec.homepage = "https://github.com/joelhelbling/mcpeasy"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 3.0.0"
@@ -33,7 +33,12 @@ Gem::Specification.new do |spec|
   # Dependencies
   spec.add_dependency "google-apis-calendar_v3", "~> 0.35"
   spec.add_dependency "google-apis-drive_v3", "~> 0.45"
+  spec.add_dependency "google-apis-gmail_v1", "~> 0.40"
   spec.add_dependency "googleauth", "~> 1.8"
+  spec.add_dependency "html2text", "~> 0.2"
+  spec.add_dependency "mail", "~> 2.8"
+  spec.add_dependency "nokogiri", "~> 1.15"
+  spec.add_dependency "signet", "~> 0.19"
   spec.add_dependency "slack-ruby-client", "~> 2.1"
   spec.add_dependency "webrick", "~> 1.8"
   spec.add_dependency "thor", "~> 1.3"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mcpeasy
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Joel Helbling
@@ -37,6 +37,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.45'
+- !ruby/object:Gem::Dependency
+  name: google-apis-gmail_v1
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.40'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.40'
 - !ruby/object:Gem::Dependency
   name: googleauth
   requirement: !ruby/object:Gem::Requirement
@@ -51,6 +65,62 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.8'
+- !ruby/object:Gem::Dependency
+  name: html2text
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: mail
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.15'
+- !ruby/object:Gem::Dependency
+  name: signet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
 - !ruby/object:Gem::Dependency
   name: slack-ruby-client
   requirement: !ruby/object:Gem::Requirement
@@ -121,8 +191,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.50'
-description: mcpeasy, LM squeezy - Easy-to-use MCP servers for Google Calendar, Google
-  Drive, Google Meet, and Slack
+description: mcpeasy, LM squeezy - Easy-to-use MCP servers for Gmail, Google Calendar,
+  Google Drive, Google Meet, and Slack
 email:
 - joel@joelhelbling.com
 executables:
@@ -134,10 +204,10 @@ files:
 - ".claudeignore"
 - ".envrc"
 - ".mcp.json"
+- CHANGELOG.md
 - CLAUDE.md
 - README.md
 - bin/mcpz
-- env.template
 - ext/setup.rb
 - lib/mcpeasy.rb
 - lib/mcpeasy/cli.rb
@@ -147,21 +217,28 @@ files:
 - lib/utilities/_google/auth_server.rb
 - lib/utilities/gcal/README.md
 - lib/utilities/gcal/cli.rb
-- lib/utilities/gcal/gcal_tool.rb
 - lib/utilities/gcal/mcp.rb
+- lib/utilities/gcal/service.rb
 - lib/utilities/gdrive/README.md
 - lib/utilities/gdrive/cli.rb
-- lib/utilities/gdrive/gdrive_tool.rb
 - lib/utilities/gdrive/mcp.rb
+- lib/utilities/gdrive/service.rb
+- lib/utilities/gmail/README.md
+- lib/utilities/gmail/cli.rb
+- lib/utilities/gmail/mcp.rb
+- lib/utilities/gmail/service.rb
 - lib/utilities/gmeet/README.md
 - lib/utilities/gmeet/cli.rb
-- lib/utilities/gmeet/gmeet_tool.rb
 - lib/utilities/gmeet/mcp.rb
+- lib/utilities/gmeet/service.rb
+- lib/utilities/notion/README.md
+- lib/utilities/notion/cli.rb
+- lib/utilities/notion/mcp.rb
+- lib/utilities/notion/service.rb
 - lib/utilities/slack/README.md
 - lib/utilities/slack/cli.rb
 - lib/utilities/slack/mcp.rb
-- lib/utilities/slack/slack_tool.rb
-- logs/.keep
+- lib/utilities/slack/service.rb
 - mcpeasy.gemspec
 homepage: https://github.com/joelhelbling/mcpeasy
 licenses:
@@ -185,7 +262,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 3.6.9
 specification_version: 4
 summary: MCP servers made easy
 test_files: []

data/env.template

@@ -1,11 +0,0 @@
-# Copy this file to .env and replace the placeholders with your own values
-
-# Used by the slack_poster.rb script
-SLACK_BOT_TOKEN=xoxb-REPLACE-ME
-
-# Used by the Github MCP Server
-GITHUB_PERSONAL_ACCESS_TOKEN=github_pat_REPLACE_ME
-
-# Used by the Google Drive MCP Server
-GOOGLE_CLIENT_ID=your_client_id_here.apps.googleusercontent.com
-GOOGLE_CLIENT_SECRET=your_client_secret_here

data/lib/utilities/gcal/gcal_tool.rb

@@ -1,308 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/setup"
-require "google/apis/calendar_v3"
-require "googleauth"
-require "signet/oauth_2/client"
-require "fileutils"
-require "json"
-require "time"
-require_relative "../_google/auth_server"
-require_relative "../../mcpeasy/config"
-
-class GcalTool
-  SCOPES = [
-    "https://www.googleapis.com/auth/calendar.readonly",
-    "https://www.googleapis.com/auth/drive.readonly"
-  ]
-  SCOPE = SCOPES.join(" ")
-
-  def initialize(skip_auth: false)
-    ensure_env!
-    @service = Google::Apis::CalendarV3::CalendarService.new
-    @service.authorization = authorize unless skip_auth
-  end
-
-  def list_events(start_date: nil, end_date: nil, max_results: 20, calendar_id: "primary")
-    # Default to today if no start date provided
-    start_time = start_date ? Time.parse("#{start_date} 00:00:00") : Time.now.beginning_of_day
-    # Default to 7 days from start if no end date provided
-    end_time = end_date ? Time.parse("#{end_date} 23:59:59") : start_time + 7 * 24 * 60 * 60
-
-    results = @service.list_events(
-      calendar_id,
-      max_results: max_results,
-      single_events: true,
-      order_by: "startTime",
-      time_min: start_time.utc.iso8601,
-      time_max: end_time.utc.iso8601
-    )
-
-    events = results.items.map do |event|
-      {
-        id: event.id,
-        summary: event.summary,
-        description: event.description,
-        location: event.location,
-        start: format_event_time(event.start),
-        end: format_event_time(event.end),
-        attendees: format_attendees(event.attendees),
-        html_link: event.html_link,
-        calendar_id: calendar_id
-      }
-    end
-
-    {events: events, count: events.length}
-  rescue Google::Apis::Error => e
-    raise "Google Calendar API Error: #{e.message}"
-  rescue => e
-    log_error("list_events", e)
-    raise e
-  end
-
-  def list_calendars
-    results = @service.list_calendar_lists
-
-    calendars = results.items.map do |calendar|
-      {
-        id: calendar.id,
-        summary: calendar.summary,
-        description: calendar.description,
-        time_zone: calendar.time_zone,
-        access_role: calendar.access_role,
-        primary: calendar.primary
-      }
-    end
-
-    {calendars: calendars, count: calendars.length}
-  rescue Google::Apis::Error => e
-    raise "Google Calendar API Error: #{e.message}"
-  rescue => e
-    log_error("list_calendars", e)
-    raise e
-  end
-
-  def search_events(query, start_date: nil, end_date: nil, max_results: 10)
-    # Default to today if no start date provided
-    start_time = start_date ? Time.parse("#{start_date} 00:00:00") : Time.now.beginning_of_day
-    # Default to 30 days from start if no end date provided
-    end_time = end_date ? Time.parse("#{end_date} 23:59:59") : start_time + 30 * 24 * 60 * 60
-
-    results = @service.list_events(
-      "primary",
-      q: query,
-      max_results: max_results,
-      single_events: true,
-      order_by: "startTime",
-      time_min: start_time.utc.iso8601,
-      time_max: end_time.utc.iso8601
-    )
-
-    events = results.items.map do |event|
-      {
-        id: event.id,
-        summary: event.summary,
-        description: event.description,
-        location: event.location,
-        start: format_event_time(event.start),
-        end: format_event_time(event.end),
-        attendees: format_attendees(event.attendees),
-        html_link: event.html_link,
-        calendar_id: "primary"
-      }
-    end
-
-    {events: events, count: events.length}
-  rescue Google::Apis::Error => e
-    raise "Google Calendar API Error: #{e.message}"
-  rescue => e
-    log_error("search_events", e)
-    raise e
-  end
-
-  def test_connection
-    calendar = @service.get_calendar("primary")
-    {
-      ok: true,
-      user: calendar.summary,
-      email: calendar.id
-    }
-  rescue Google::Apis::Error => e
-    raise "Google Calendar API Error: #{e.message}"
-  rescue => e
-    log_error("test_connection", e)
-    raise e
-  end
-
-  def authenticate
-    perform_auth_flow
-    {success: true}
-  rescue => e
-    {success: false, error: e.message}
-  end
-
-  def perform_auth_flow
-    client_id = Mcpeasy::Config.google_client_id
-    client_secret = Mcpeasy::Config.google_client_secret
-
-    unless client_id && client_secret
-      raise "Google credentials not found. Please save your credentials.json file using: mcpz config set_google_credentials <path_to_credentials.json>"
-    end
-
-    # Create credentials using OAuth2 flow with localhost redirect
-    redirect_uri = "http://localhost:8080"
-    client = Signet::OAuth2::Client.new(
-      client_id: client_id,
-      client_secret: client_secret,
-      scope: SCOPE,
-      redirect_uri: redirect_uri,
-      authorization_uri: "https://accounts.google.com/o/oauth2/auth",
-      token_credential_uri: "https://oauth2.googleapis.com/token"
-    )
-
-    # Generate authorization URL
-    url = client.authorization_uri.to_s
-
-    puts "DEBUG: Client ID: #{client_id[0..20]}..."
-    puts "DEBUG: Scope: #{SCOPE}"
-    puts "DEBUG: Redirect URI: #{redirect_uri}"
-    puts
-
-    # Start callback server to capture OAuth code
-    puts "Starting temporary web server to capture OAuth callback..."
-    puts "Opening authorization URL in your default browser..."
-    puts url
-    puts
-
-    # Automatically open URL in default browser on macOS/Unix
-    if system("which open > /dev/null 2>&1")
-      system("open", url)
-    else
-      puts "Could not automatically open browser. Please copy the URL above manually."
-    end
-    puts
-    puts "Waiting for OAuth callback... (will timeout in 60 seconds)"
-
-    # Wait for the authorization code with timeout
-    code = GoogleAuthServer.capture_auth_code
-
-    unless code
-      raise "Failed to receive authorization code. Please try again."
-    end
-
-    puts "✅ Authorization code received!"
-    client.code = code
-    client.fetch_access_token!
-
-    # Save credentials to config
-    credentials_data = {
-      client_id: client.client_id,
-      client_secret: client.client_secret,
-      scope: client.scope,
-      refresh_token: client.refresh_token,
-      access_token: client.access_token,
-      expires_at: client.expires_at
-    }
-
-    Mcpeasy::Config.save_google_token(credentials_data)
-    puts "✅ Authentication successful! Token saved to config"
-
-    client
-  rescue => e
-    log_error("perform_auth_flow", e)
-    raise "Authentication flow failed: #{e.message}"
-  end
-
-  private
-
-  def authorize
-    credentials_data = Mcpeasy::Config.google_token
-    unless credentials_data
-      raise <<~ERROR
-        Google Calendar authentication required!
-        Run the auth command first:
-        mcpz gcal auth
-      ERROR
-    end
-
-    client = Signet::OAuth2::Client.new(
-      client_id: credentials_data.client_id,
-      client_secret: credentials_data.client_secret,
-      scope: credentials_data.scope.respond_to?(:to_a) ? credentials_data.scope.to_a.join(" ") : credentials_data.scope.to_s,
-      refresh_token: credentials_data.refresh_token,
-      access_token: credentials_data.access_token,
-      token_credential_uri: "https://oauth2.googleapis.com/token"
-    )
-
-    # Check if token needs refresh
-    if credentials_data.expires_at
-      expires_at = if credentials_data.expires_at.is_a?(String)
-        Time.parse(credentials_data.expires_at)
-      else
-        Time.at(credentials_data.expires_at)
-      end
-
-      if Time.now >= expires_at
-        client.refresh!
-        # Update saved credentials with new access token
-        updated_data = {
-          client_id: credentials_data.client_id,
-          client_secret: credentials_data.client_secret,
-          scope: credentials_data.scope.respond_to?(:to_a) ? credentials_data.scope.to_a.join(" ") : credentials_data.scope.to_s,
-          refresh_token: credentials_data.refresh_token,
-          access_token: client.access_token,
-          expires_at: client.expires_at
-        }
-        Mcpeasy::Config.save_google_token(updated_data)
-      end
-    end
-
-    client
-  rescue JSON::ParserError
-    raise "Invalid token data. Please re-run: mcpz gcal auth"
-  rescue => e
-    log_error("authorize", e)
-    raise "Authentication failed: #{e.message}"
-  end
-
-  def ensure_env!
-    unless Mcpeasy::Config.google_client_id && Mcpeasy::Config.google_client_secret
-      raise <<~ERROR
-        Google API credentials not configured!
-        Please save your Google credentials.json file using:
-        mcpz config set_google_credentials <path_to_credentials.json>
-      ERROR
-    end
-  end
-
-  def format_event_time(event_time)
-    return nil unless event_time
-
-    if event_time.date
-      # All-day event
-      {date: event_time.date}
-    elsif event_time.date_time
-      # Specific time event
-      {date_time: event_time.date_time.iso8601}
-    else
-      nil
-    end
-  end
-
-  def format_attendees(attendees)
-    return [] unless attendees
-
-    attendees.map do |attendee|
-      attendee.email
-    end.compact
-  end
-
-  def log_error(method, error)
-    Mcpeasy::Config.ensure_config_dirs
-    File.write(
-      Mcpeasy::Config.log_file_path("gcal", "error"),
-      "#{Time.now}: #{method} error: #{error.class}: #{error.message}\n#{error.backtrace.join("\n")}\n",
-      mode: "a"
-    )
-  end
-end