Happy slice of mcp pizzaMCP.pizza

mcp-pa-ai-agent

MCP.Pizza Chef: zhangzhongnan928

mcp-pa-ai-agent is a personal assistant AI client built on the Model Context Protocol (MCP) that integrates with MCP servers and clients to manage calendar events, track tasks, handle emails, perform web searches, and control smart home devices. It requires Python 3.10+ and MCP SDK 1.2.0+, enabling seamless AI-driven personal productivity workflows and smart environment interactions.

Unmaintained · No commits in 18 months.

Use This MCP client To

Manage and schedule calendar events via AI commands Track and update personal tasks and to-do lists Read, compose, and send emails through AI interaction Search the web and retrieve relevant information Control smart home devices using natural language Integrate with MCP clients like Claude for Desktop Automate daily personal assistant workflows Coordinate multi-step task management with AI

README

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:
git clone https://github.com/yourusername/mcp-pa-ai-agent.git
cd mcp-pa-ai-agent
  1. Ensure you have Python 3.10+:
python --version
  1. If your system Python is older than 3.10, set up a compatible environment:
# 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
  1. Install dependencies:
pip install -r requirements.txt
  1. Configure environment variables by copying the example file:
cp .env.example .env
  1. Edit the .env file with your API credentials and settings.

Running the Server

Start the MCP server with:

python mcp_server.py

The server will start and listen for MCP client connections.

mcp-pa-ai-agent FAQ

What Python version is required to run mcp-pa-ai-agent?
Python 3.10 or higher is required to ensure compatibility with the MCP SDK and the agent's features.
How does mcp-pa-ai-agent integrate with other MCP components?
It acts as an MCP client that connects to MCP servers and clients like Claude for Desktop to provide personal assistant capabilities.
Can mcp-pa-ai-agent control smart home devices?
Yes, it supports controlling smart home devices through natural language commands integrated via MCP.
What functionalities does mcp-pa-ai-agent provide?
It manages calendar events, tasks, emails, web searches, and smart home device control.
Is mcp-pa-ai-agent limited to a specific LLM provider?
No, it is designed to work with multiple LLM providers such as OpenAI, Claude, and Gemini.
What are the installation prerequisites for mcp-pa-ai-agent?
You need Python 3.10+, MCP SDK 1.2.0+, and required Python packages listed in requirements.txt.
Can mcp-pa-ai-agent automate multi-step workflows?
Yes, it can coordinate complex personal assistant tasks involving multiple steps and data sources.
How do I start using mcp-pa-ai-agent after installation?
Clone the repository, ensure Python 3.10+, install dependencies, and configure it to connect with your MCP environment.