MCP-Server-based-Ai-Automation-hub by Maheshnath09 - MCP Server

🤖 MCP Server based Ai Automation Hub

Your central command center for Notion & Google Workspace automation.

Bridge the gap between AI assistants and productivity tools with 8 powerful automation tools.

🏗️ Architecture

flowchart TB
    subgraph Client["🖥️ MCP Client"]
        Claude["Claude Desktop / Cursor"]
    end
    
    subgraph Server["⚡ Automation Hub MCP Server"]
        MCP["FastMCP Server"]
        Auth["OAuth Handler"]
        
        subgraph Tools["🛠️ 8 Automation Tools"]
            direction LR
            Notion["📝 Notion\n• add_task\n• get_tasks"]
            Calendar["📅 Calendar\n• create_event\n• get_events"]
            Gmail["📧 Gmail\n• send_email\n• get_unread"]
            Sheets["📊 Sheets\n• add_row\n• read_data"]
        end
    end
    
    subgraph APIs["☁️ External APIs"]
        NotionAPI["Notion API"]
        GoogleAPI["Google APIs"]
    end
    
    Claude <-->|"stdio"| MCP
    MCP --> Tools
    Auth --> GoogleAPI
    Notion --> NotionAPI
    Calendar --> GoogleAPI
    Gmail --> GoogleAPI
    Sheets --> GoogleAPI

✨ Features

Integration	Tools	Description
📝 Notion	`add_notion_task`, `get_notion_tasks`	Create and retrieve tasks from your Notion database
📅 Calendar	`create_calendar_event`, `get_upcoming_events`	Schedule meetings and check your agenda
📧 Gmail	`send_gmail`, `get_unread_emails`	Send emails and fetch unread message summaries
📊 Sheets	`add_google_sheet_row`, `read_google_sheet`	Log data and read spreadsheet ranges

🛠️ Prerequisites

Python 3.10+
uv package manager (recommended)
Google Cloud Project with APIs enabled:
- Google Sheets API
- Google Calendar API
- Gmail API
Notion Integration with database access

⚙️ Quick Setup

1. Install Dependencies

git clone https://github.com/Maheshnath09/ai-automation-hub.git
cd ai-automation-hub
uv sync

2. Configure Environment

Create .env file:

NOTION_API_KEY=secret_your_notion_integration_token
NOTION_DATABASE_ID=your_database_id

3. Add Google Credentials

Download OAuth 2.0 Client ID from Google Cloud Console and save as credentials.json.

4. Run the Server

uv run run_server.py

First Run: A browser window will open for Google OAuth authentication.

🔗 Claude Desktop Integration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "automation_hub": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\path\\to\\ai-automation-hub",
        "run",
        "run_server.py"
      ]
    }
  }
}

Then enable automation_hub in Claude Desktop → Settings → Connectors.

🧪 Testing

uv run src/test_integration.py

Verifies:

✅ Notion task creation & retrieval
✅ Google Calendar event management
✅ Gmail unread email fetching

🐳 Docker Support

# Build
docker build -t automation-hub .

# Run
docker run -i --rm \
  -v ${PWD}/.env:/app/.env \
  -v ${PWD}/credentials.json:/app/credentials.json \
  -v ${PWD}/token.json:/app/token.json \
  automation-hub

📁 Project Structure

ai-automation-hub/
├── src/
│   ├── server.py          # FastMCP server with 8 tools
│   ├── auth.py             # Google OAuth handling
│   ├── google_services.py  # Calendar, Gmail, Sheets clients
│   ├── notion.py           # Notion API client
│   └── main.py             # Module entry point
├── run_server.py           # Standalone server entry
├── credentials.json        # Google OAuth config
├── .env                    # Notion credentials
└── pyproject.toml          # Dependencies

📜 License

MIT License - Built with ❤️ for automation enthusiasts.