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.

Install the gem globally:

gem install mcpeasy

This makes the mcpz command available system-wide for both CLI usage and MCP server configuration.

This gem includes the following MCP servers, each providing both CLI and MCP server functionality:

Post messages to Slack channels and list available channels.

• CLI: Direct message posting with custom usernames
• MCP: Integration for AI assistants to send Slack notifications

Access and search Google Calendar events.

• CLI: List events, search by date range, view calendar information
• MCP: AI assistant access to calendar data and event search

Search and retrieve files from Google Drive with automatic format conversion.

• CLI: Search files, list recent files, retrieve content
• MCP: AI assistant access to Drive files and documents

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

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

First, create the configuration directories:

mcpz setup

Then configure your API credentials for each service you plan to use:

# For Slack
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).

Each MCP server can be used directly from the command line:

# Slack
mcpz slack post general "Hello from Ruby!"

# Google Calendar  
mcpz gcal events --start "2024-01-01"

# Google Drive
mcpz gdrive search "quarterly report"

# Google Meet
mcpz gmeet upcoming

# Notion
mcpz notion search_pages "meeting notes"

For use with Claude Code, add servers to your .mcp.json:

{
  "mcpServers": {
    "slack": {
      "command": "mcpz",
      "args": ["slack", "mcp"]
    },
    "gcal": {
      "command": "mcpz", 
      "args": ["gcal", "mcp"]
    },
    "gdrive": {
      "command": "mcpz",
      "args": ["gdrive", "mcp"]
    },
    "gmeet": {
      "command": "mcpz",
      "args": ["gmeet", "mcp"]
    },
    "notion": {
      "command": "mcpz",
      "args": ["notion", "mcp"]
    }
  }
}

1. Clone the repository and install dependencies:

   git clone <repository-url>
   cd mcpeasy
   bundle install

2. Create configuration directories (if not automatically created):

   # Run manually during development
   bundle exec ruby -r "./lib/mcpeasy/setup" -e "Mcpeasy::Setup.create_config_directories"
   
   # Or use the CLI command after building the gem locally
   bin/mcpz setup

Run linting before committing changes:

bundle exec standardrb

lib/
├── mcpeasy.rb           # Main gem file
├── mcpeasy/             # Gem core functionality
└── utilities/           # MCP servers
    ├── slack/           # Slack integration
    ├── gcal/            # Google Calendar
    ├── gdrive/          # Google Drive  
    ├── gmeet/           # Google Meet
    └── notion/          # Notion integration

1. Follow existing code patterns and Ruby style conventions
2. Add comprehensive error handling and logging
3. Update relevant documentation for new features
4. Test both CLI and MCP server modes
5. Run bundle exec standardrb before submitting changes

This project is licensed under the MIT License.

For issues, questions, or contributions, please visit the project repository.