mcpeasy 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a8fd6efbce3698cb6ab7c807ee5b496f6f150108779991c4b2dac8d28822a64
-  data.tar.gz: 98e8f1895a741151767ca65243f3d83adc3feb37342624c35834bf2d0e4beeb4
+  metadata.gz: 96510ec1696160a8727b73d66eb7fbe9e9ac267bcdbe7c2e3db1f3a7840657f2
+  data.tar.gz: 64d8e8b25d58845501acba165271cc31010efbff4d3b65799ed932ab244aee09
 SHA512:
-  metadata.gz: '07081dab8205a10e379933b40f9f618e7cb0ff05781f77b4ee7700c4a64b67f309346510d7677b813c09498a5172622ec8290294b4ffecdef5f6143a4777cac6'
-  data.tar.gz: 14e812027277e6035e6ab21cfb0730b35e1084c03b17ea2ca905a3654923da14fa2a8c183295904f913262a9a24e56078019384344387da7735523d8de148eb3
+  metadata.gz: 6558ab4692baf95e5144db4f888bf594e28f8031a564d5d1127d90197c509b422225ae00438b61e640b1adc1ac355a444f1361db60485586441004d26b379b54
+  data.tar.gz: 8a12fc568bd98fd4ca14ea21f8e8ae6a13ae39bf34eb877a0e1b5e4e69c581f491578710147040a84550c7c4e5e4d791695208b25951ae492d877e860fc71a4f

data/.claudeignore

@@ -1,4 +1 @@
 .env
-client_secret_*.apps.googleusercontent.com.json
-google_credentials.json
-.google-token.json

data/.mcp.json

@@ -27,6 +27,15 @@
       ],
       "env": {}
     },
+    "gmail": {
+      "type": "stdio",
+      "command": "./bin/mcpz",
+      "args": [
+        "gmail",
+        "mcp"
+      ],
+      "env": {}
+    },
     "gmeet": {
       "type": "stdio",
       "command": "./bin/mcpz",
@@ -35,6 +44,15 @@
         "mcp"
       ],
       "env": {}
+    },
+    "notion": {
+      "type": "stdio",
+      "command": "./bin/mcpz",
+      "args": [
+        "notion",
+        "mcp"
+      ],
+      "env": {}
     }
   }
-}
+}

data/CHANGELOG.md

@@ -0,0 +1,59 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.3.0] - 2025-06-07
+
+### Added
+- Gmail MCP server integration with comprehensive email support
+  - List and search emails with various filters
+  - Read email content including headers and body
+  - Send new emails and reply to existing ones
+  - Manage email labels, mark as read/unread
+  - Archive and trash emails
+  - Full OAuth2 authentication flow integration
+
+## [0.2.0] - 2025-06-03
+
+### Added
+- Notion MCP server integration with comprehensive API support
+- Pagination support for Slack channels listing
+- Pagination support for Notion user listings and database queries
+- Google Meet MCP server with meeting search and URL retrieval
+- Setup command (`mcpz setup`) for initializing configuration directories
+- Post-install message in gemspec for better user onboarding
+- Shared authentication server for Google services OAuth flow
+- MCP server mode for all services (Slack, Google Calendar, Drive, Meet, Notion)
+- CLI interface with `mcpz` command for all services
+- Configuration management system storing credentials in `~/.config/mcpeasy/`
+- Logging system with logs stored in `~/.local/share/mcpeasy/logs/`
+
+### Changed
+- Refactored project structure for better consistency and namespacing
+- Converted project from standalone scripts to Ruby gem
+- Moved from individual MCP servers to unified gem architecture
+- Refactored Google services to share authentication token capture server
+- Improved MCP server implementation with fresh tool instances per call
+- Standardized service structure with consistent cli.rb, mcp.rb, service.rb pattern
+
+### Fixed
+- Emoji rendering in Google token capture service
+- Ruby code style compliance with standardrb
+
+### Removed
+- Unused project files and dependencies
+- Git submodules for external MCP servers
+- Direct dependency on ruby-sdk in favor of hand-rolled implementation
+
+## [0.1.0] - Initial Release
+
+### Added
+- Initial gem structure with Thor-based CLI
+- Slack integration with message posting and channel listing
+- Google Calendar integration with event listing and search
+- Google Drive integration with file search and content retrieval
+- Basic MCP server implementations for all services
+- Development tooling with standardrb for code quality

data/CLAUDE.md

@@ -2,6 +2,10 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+## Important Reminders
+
+**Date/Time Accuracy**: The environment context date provided at startup may be incorrect. Always verify the current date and time using the `date` command when needed. Also watch out for time/date terms which are relative to today's date, e.g. "tomorrow", "this week" or "the next 48 hours".
+
 ## Project Overview
 
 **MCPEasy** is a Ruby gem that provides multiple Model Context Protocol (MCP) servers for integrating with AI assistants like Claude Code. The gem includes MCP servers for:
@@ -67,6 +71,16 @@ Run linting:
 bundle exec standardrb
 ```
 
+Searching within project files:
+```bash
+git grep "search pattern example"
+```
+
+Move or rename files:
+```bash
+git mv old_file_name new_file_name
+```
+
 Build gem:
 ```bash
 gem build mcpeasy.gemspec
@@ -139,21 +153,21 @@ Each service directory follows a consistent structure with four key components:
 - Extends Thor for command-line interface functionality
 - Provides user-friendly CLI commands for the service
 - Handles argument parsing and validation
-- Calls into the `*_tool.rb` for actual service operations
+- Calls into the `service.rb` for actual service operations
 - Example: `mcpz slack post` command implementation
 
 ##### `mcp.rb` - MCP Server Implementation
 - Implements the Model Context Protocol JSON-RPC server
 - Handles MCP initialization, tool registration, and request processing
-- Translates MCP tool calls into `*_tool.rb` method calls
+- Translates MCP tool calls into `service.rb` method calls
 - Provides structured responses back to AI assistants
 - Runs as a persistent server process when called with `mcpz [service] mcp`
 
-##### `*_tool.rb` - Core Service Functionality
+##### `service.rb` - Core Service Functionality
 - Contains the main business logic for interacting with external APIs
 - Handles authentication, API calls, error handling, and response formatting
 - Shared between both CLI and MCP modes for consistency
-- Service-specific naming: `slack_tool.rb`, `gcal_tool.rb`, `gdrive_tool.rb`, `gmeet_tool.rb`
+- Each service has its own `service.rb` file within its directory
 - Designed to be framework-agnostic and reusable
 
 ##### `README.md` - Service-specific Documentation
@@ -167,4 +181,4 @@ Each service directory follows a consistent structure with four key components:
 All services follow the same pattern:
 1. **CLI mode**: Direct command-line usage via `mcpz [service] [command]`
 2. **MCP mode**: JSON-RPC server mode via `mcpz [service] mcp`
-3. **Authentication**: Service-specific auth handling with shared config storage
+3. **Authentication**: Service-specific auth handling with shared config storage

data/README.md

@@ -1,4 +1,4 @@
-# MCPEasy
+# MCPeasy
 
 A Ruby gem that provides multiple Model Context Protocol (MCP) servers for integrating with AI assistants like Claude Code. Each MCP server provides programmatic access to popular web services and APIs.
 
@@ -36,6 +36,11 @@ Find and manage Google Meet meetings from your calendar.
 - CLI: List meetings, search by content, get meeting URLs
 - MCP: AI assistant access to upcoming meetings and direct links
 
+### 📝 [Notion](./lib/utilities/notion/)
+Search pages and databases in your Notion workspace.
+- CLI: Search pages/databases, retrieve content, query database entries
+- MCP: AI assistant access to Notion workspace content and organization
+
 ## Quick Start
 
 ### 1. Configuration Setup
@@ -54,6 +59,9 @@ mcpz slack set_bot_token xoxb-your-slack-token
 
 # For Google services (Calendar, Drive, Meet)
 mcpz google auth
+
+# For Notion
+mcpz notion set_api_key secret_your-notion-integration-token
 ```
 
 Credentials are stored securely in `~/.config/mcpeasy/` (see individual server documentation for specific setup requirements).
@@ -74,6 +82,9 @@ mcpz gdrive search "quarterly report"
 
 # Google Meet
 mcpz gmeet upcoming
+
+# Notion
+mcpz notion search_pages "meeting notes"
 ```
 
 ### 3. MCP Server Configuration
@@ -98,6 +109,10 @@ For use with Claude Code, add servers to your `.mcp.json`:
     "gmeet": {
       "command": "mcpz",
       "args": ["gmeet", "mcp"]
+    },
+    "notion": {
+      "command": "mcpz",
+      "args": ["notion", "mcp"]
     }
   }
 }
@@ -141,7 +156,8 @@ lib/
     ├── slack/           # Slack integration
     ├── gcal/            # Google Calendar
     ├── gdrive/          # Google Drive  
-    └── gmeet/           # Google Meet
+    ├── gmeet/           # Google Meet
+    └── notion/          # Notion integration
 ```
 
 ### Contributing
@@ -158,4 +174,4 @@ This project is licensed under the MIT License.
 
 ## Support
 
-For issues, questions, or contributions, please visit the project repository.
+For issues, questions, or contributions, please visit the project repository.

data/lib/mcpeasy/cli.rb

@@ -7,8 +7,8 @@ module Mcpeasy
   class GoogleCommands < Thor
     desc "auth", "Authenticate with Google services (Calendar, Drive, Meet)"
     def auth
-      require_relative "../utilities/gcal/gcal_tool"
-      tool = GcalTool.new(skip_auth: true)
+      require_relative "../utilities/gcal/service"
+      tool = Gcal::Service.new(skip_auth: true)
       result = tool.authenticate
       if result[:success]
         puts "✅ Successfully authenticated with Google services"
@@ -23,52 +23,52 @@ module Mcpeasy
   # Load the existing GcalCLI and extend it with MCP functionality
   require_relative "../utilities/gcal/cli"
 
-  class GcalCommands < GcalCLI
+  class GcalCommands < Gcal::CLI
     namespace "gcal"
 
     desc "mcp", "Run Google Calendar MCP server"
     def mcp
       require_relative "../utilities/gcal/mcp"
-      MCPServer.new.run
+      Gcal::MCPServer.new.run
     end
   end
 
   # Load the existing GdriveCLI and extend it with MCP functionality
   require_relative "../utilities/gdrive/cli"
 
-  class GdriveCommands < GdriveCLI
+  class GdriveCommands < Gdrive::CLI
     namespace "gdrive"
 
     desc "mcp", "Run Google Drive MCP server"
     def mcp
       require_relative "../utilities/gdrive/mcp"
-      MCPServer.new.run
+      Gdrive::MCPServer.new.run
     end
   end
 
   # Load the existing GmeetCLI and extend it with MCP functionality
   require_relative "../utilities/gmeet/cli"
 
-  class GmeetCommands < GmeetCLI
+  class GmeetCommands < Gmeet::CLI
     namespace "gmeet"
 
     desc "mcp", "Run Google Meet MCP server"
     def mcp
       require_relative "../utilities/gmeet/mcp"
-      MCPServer.new.run
+      Gmeet::MCPServer.new.run
     end
   end
 
   # Load the existing SlackCLI and extend it with MCP functionality
   require_relative "../utilities/slack/cli"
 
-  class SlackCommands < SlackCLI
+  class SlackCommands < Slack::CLI
     namespace "slack"
 
     desc "mcp", "Run Slack MCP server"
     def mcp
       require_relative "../utilities/slack/mcp"
-      MCPServer.new.run
+      Slack::MCPServer.new.run
     end
 
     desc "set_bot_token TOKEN", "Set Slack bot token"
@@ -84,6 +84,51 @@ module Mcpeasy
     end
   end
 
+  # Load the existing NotionCLI and extend it with MCP functionality
+  require_relative "../utilities/notion/cli"
+
+  class NotionCommands < Notion::CLI
+    namespace "notion"
+
+    desc "mcp", "Run Notion MCP server"
+    def mcp
+      require_relative "../utilities/notion/mcp"
+      Notion::MCPServer.new.run
+    end
+
+    desc "set_api_key API_KEY", "Set Notion API key"
+    def set_api_key(api_key)
+      Config.save_notion_api_key(api_key)
+      puts "✅ Notion API key saved successfully"
+    end
+  end
+
+  # Load the existing GmailCLI and extend it with MCP functionality
+  require_relative "../utilities/gmail/cli"
+
+  class GmailCommands < Gmail::CLI
+    namespace "gmail"
+
+    desc "mcp", "Run Gmail MCP server"
+    def mcp
+      require_relative "../utilities/gmail/mcp"
+      Gmail::MCPServer.new.run
+    end
+
+    desc "auth", "Authenticate with Gmail API"
+    def auth
+      require_relative "../utilities/gmail/service"
+      tool = Gmail::Service.new(skip_auth: true)
+      result = tool.authenticate
+      if result[:success]
+        puts "✅ Successfully authenticated with Gmail"
+      else
+        puts "❌ Authentication failed: #{result[:error]}"
+        exit 1
+      end
+    end
+  end
+
   class CLI < Thor
     desc "version", "Show mcpeasy version"
     def version
@@ -105,6 +150,7 @@ module Mcpeasy
       puts "🔑 Google credentials: #{status[:google_credentials] ? "✅" : "❌"}"
       puts "🎫 Google token: #{status[:google_token] ? "✅" : "❌"}"
       puts "💬 Slack config: #{status[:slack_config] ? "✅" : "❌"}"
+      puts "📝 Notion config: #{status[:notion_config] ? "✅" : "❌"}"
     end
 
     desc "set_google_credentials PATH", "Save Google credentials from downloaded JSON file"
@@ -143,6 +189,12 @@ module Mcpeasy
     desc "slack COMMAND", "Slack commands"
     subcommand "slack", SlackCommands
 
+    desc "notion COMMAND", "Notion commands"
+    subcommand "notion", NotionCommands
+
+    desc "gmail COMMAND", "Gmail commands"
+    subcommand "gmail", GmailCommands
+
     class << self
       private
 

data/lib/mcpeasy/config.rb

@@ -9,6 +9,7 @@ module Mcpeasy
     CONFIG_DIR = File.expand_path("~/.config/mcpeasy").freeze
     GOOGLE_DIR = File.join(CONFIG_DIR, "google").freeze
     SLACK_DIR = File.join(CONFIG_DIR, "slack").freeze
+    NOTION_DIR = File.join(CONFIG_DIR, "notion").freeze
     LOGS_DIR = File.expand_path("~/.local/share/mcpeasy/logs").freeze
 
     class << self
@@ -16,6 +17,7 @@ module Mcpeasy
         FileUtils.mkdir_p(CONFIG_DIR)
         FileUtils.mkdir_p(GOOGLE_DIR)
         FileUtils.mkdir_p(SLACK_DIR)
+        FileUtils.mkdir_p(NOTION_DIR)
         FileUtils.mkdir_p(LOGS_DIR)
       end
 
@@ -79,6 +81,24 @@ module Mcpeasy
         File.write(slack_token_path, JSON.pretty_generate(config))
       end
 
+      # Notion configuration
+      def notion_token_path
+        File.join(NOTION_DIR, "token.json")
+      end
+
+      def notion_api_key
+        return nil unless File.exist?(notion_token_path)
+        config = JSON.parse(File.read(notion_token_path))
+        config["api_key"]
+      end
+
+      def save_notion_api_key(api_key)
+        ensure_config_dirs
+        config = File.exist?(notion_token_path) ? JSON.parse(File.read(notion_token_path)) : {}
+        config["api_key"] = api_key
+        File.write(notion_token_path, JSON.pretty_generate(config))
+      end
+
       # Logs directory
       def logs_dir
         LOGS_DIR
@@ -94,7 +114,8 @@ module Mcpeasy
           logs_dir: LOGS_DIR,
           google_credentials: File.exist?(google_credentials_path),
           google_token: File.exist?(google_token_path),
-          slack_config: File.exist?(slack_token_path)
+          slack_config: File.exist?(slack_token_path),
+          notion_config: File.exist?(notion_token_path)
         }
       end
     end

data/lib/mcpeasy/setup.rb

@@ -14,6 +14,7 @@ module Mcpeasy
       puts "Created #{Config::CONFIG_DIR}"
       puts "Created #{Config::GOOGLE_DIR}"
       puts "Created #{Config::SLACK_DIR}"
+      puts "Created #{Config::NOTION_DIR}"
       puts "Created #{Config::LOGS_DIR}"
 
       puts "mcpeasy setup complete!"

data/lib/mcpeasy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mcpeasy
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/utilities/gcal/README.md

@@ -128,6 +128,14 @@ The server provides these tools to Claude Code:
 - **list_calendars**: List available calendars
 - **search_events**: Search for events by text content
 
+The server also provides helpful prompts for common calendar queries:
+
+- **check_schedule**: Check your calendar schedule for a specific time period
+- **find_meeting**: Find a specific meeting or event by searching for keywords
+- **check_availability**: Check if you're free at a specific time
+- **weekly_overview**: Get an overview of your schedule for the upcoming week
+- **meeting_conflicts**: Check for any overlapping or back-to-back meetings
+
 ## Security & Permissions
 
 ### Required OAuth Scopes
@@ -201,14 +209,14 @@ tail -f logs/mcp_gcal_startup.log
 utilities/gcal/
 ├── cli.rb          # Thor-based CLI interface
 ├── mcp.rb          # MCP server implementation  
-├── gcal_tool.rb    # Google Calendar API wrapper
+├── service.rb      # Google Calendar API wrapper
 └── README.md       # This file
 ```
 
 ### Adding New Features
 
-1. **New API methods**: Add to `GcalTool` class
-2. **New CLI commands**: Add to `GcalCLI` class  
+1. **New API methods**: Add to `Service` class
+2. **New CLI commands**: Add to `CLI` class  
 3. **New MCP tools**: Add to `MCPServer` class
 
 ### Testing