iflow-mcp_mcp-pa-ai-agent

# MCP Personal Assistant Agent A versatile personal assistant AI agent built with the Model Context Protocol (MCP) that helps with calendar, tasks, emails, and more. ## Overview This project is a Model Context Protocol (MCP) server that provides a set of tools for a personal assistant agent. It can be integrated with MCP clients like Claude for Desktop to give AI assistants the ability to: - Manage calendar events - Track tasks and to-dos - Read and send emails - Search the web and retrieve information - Control smart home devices ## Requirements ⚠️ **IMPORTANT:** Python 3.10 or higher is required for the MCP SDK. The server will not work with earlier Python versions. - Python 3.10+ - MCP SDK 1.2.0+ - Required Python packages (see requirements.txt) ## Installation 1. Clone the repository: ```bash git clone https://github.com/yourusername/mcp-pa-ai-agent.git cd mcp-pa-ai-agent ``` 2. Ensure you have Python 3.10+: ```bash python --version ``` 3. If your system Python is older than 3.10, set up a compatible environment: ```bash # Using conda conda create -n mcp-env python=3.10 conda activate mcp-env # OR using venv (if Python 3.10+ is installed elsewhere) python3.10 -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate ``` 4. Install dependencies: ```bash pip install -r requirements.txt ``` 5. Configure environment variables by copying the example file: ```bash cp .env.example .env ``` 6. Edit the `.env` file with your API credentials and settings. ## Running the Server Start the MCP server with: ```bash python mcp_server.py ``` The server will start and listen for MCP client connections. ## Connecting to Claude for Desktop 1. Install [Claude for Desktop](https://claude.ai/desktop) 2. Configure Claude for Desktop to use this MCP server by editing the configuration file at: - MacOS/Linux: `~/Library/Application Support/Claude/claude_desktop_config.json` - Windows: `%APPDATA%\Claude\claude_desktop_config.json` 3. Add th…