MCP Personal Assistant Agent

MCP Personal Assistant Agent is an MCP server that connects AI clients to productivity services, external web information, and smart home automation platforms. Designed for individuals and power users who want an integrated personal AI manager, it interfaces with Google APIs for calendars and emails, Home Assistant for IoT device management, and public APIs for weather, news, and web search. By exposing these services as Model Context Protocol tools, it enables LLMs to fetch and create calendar appointments, track and update task progress, read inbox threads, compose emails, look up real-time web content, and monitor or control home devices. Users can operate their personal schedule and home environment directly through natural language prompts inside supported MCP clients like Claude for Desktop.

Category: Communication & Messaging

Tags: calendar, email, personal assistant, smart-home, tasks

Visit MCP Personal Assistant Agent

How to install and configure MCP Personal Assistant Agent

1. Ensure Python 3.10 or higher is installed on your system. 2. Clone the repository and enter the directory: bash git clone https://github.com/zhangzhongnan928/mcp-pa-ai-agent.git cd mcp-pa-ai-agent 3. Install the dependencies: bash pip install -r requirements.txt 4. Copy the environment configuration template and set your credentials: bash cp .env.example .env 5. Open your Claude for Desktop configuration file (claude_desktop_config.json) and register the server: json { "mcpServers": { "personal-assistant": { "command": "/path/to/python", "args": [ "/absolute/path/to/mcp-pa-ai-agent/mcp_server.py" ] } } } 6. Restart Claude for Desktop to complete the setup.

What you can do with MCP Personal Assistant Agent

• Scheduling calendar appointments and fetching upcoming agenda events directly from conversational prompts in Claude. - Managing to-do lists by querying items, creating new tasks, and updating completion status dynamically. - Reading recent inbox messages and drafting or dispatching outbound emails via Google API integration. - Querying real-time weather forecasts, current news headlines, or general search queries through web APIs. - Controlling smart home devices such as lights and thermostats, and checking device states via Home Assistant.

Key facts

• https://github.com/zhangzhongnan928/mcp-pa-ai-agent
• Communication & Messaging, Project & Task Management, Web Search & Research
• calendar, email, personal assistant, smart-home, tasks

Part of MCP Servers

What is MCP Personal Assistant Agent?

MCP Personal Assistant Agent is a Model Context Protocol server that equips AI clients with tools to manage calendars, tasks, emails, web lookups, and smart home automation through unified interfaces.

Which Python version is required for MCP Personal Assistant Agent?

The server requires Python 3.10 or higher because of the MCP SDK requirements. It will fail to run on older Python environments, so you should use Python 3.10+ in your virtual environment.

What tools are included in MCP Personal Assistant Agent?

The server provides tools for managing calendars (get_events, create_event), tracking tasks (list_tasks, add_task, update_task_status), handling email (get_emails, read_email, send_email), checking knowledge (web_search, get_weather, get_news), and smart home control (list_devices, control_device, get_device_state).

How do I configure external services for this server?

Copy the provided .env.example file to .env and configure the necessary credentials, such as Google API OAuth keys for calendar and email, weather and news API keys, and Home Assistant credentials for smart home devices.

Is MCP Personal Assistant Agent open source?

Yes, MCP Personal Assistant Agent is open source and licensed under the MIT License on GitHub.