MCP Personal Assistant Agent

A personal assistant AI agent built with the Model Context Protocol (MCP)

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "zhangzhongnan928-mcp-pa-ai-agent": {
      "command": "python",
      "args": [
        "mcp_server.py"
      ],
      "env": {
        "NEWS_API_KEY": "YOUR_NEWS_API_KEY",
        "WEATHER_API_KEY": "YOUR_WEATHER_API_KEY",
        "HOME_ASSISTANT_URL": "http://homeassistant.local:8123",
        "GOOGLE_API_CREDENTIALS": "path/to/credentials.json"
      }
    }
  }
}

You deploy an MCP server that acts as a versatile personal assistant, enabling your AI to manage calendars, tasks, emails, web queries, and smart home devices through a standardized MCP interface.

How to use

You run the MCP Personal Assistant Agent server locally or on a host, then connect an MCP client to it. The server exposes a set of tools you can invoke to manage your calendar, track tasks, read and send emails, perform web searches, fetch weather or news, and control smart home devices. Use your MCP client to call these tools in natural language tasks, such as creating a calendar event, listing upcoming tasks, or querying the latest weather.

How to install

Follow these steps to install and run the MCP Personal Assistant Agent server.

# 1) Clone the project
git clone https://github.com/zhangzhongnan928/mcp-pa-ai-agent.git
cd mcp-pa-ai-agent

# 2) Check Python version
python --version

# 3) Create a compatible environment if needed
# Using conda
conda create -n mcp-env python=3.10
conda activate mcp-env

# OR using venv
python3.10 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# 4) Install dependencies
pip install -r requirements.txt

# 5) Configure environment variables
cp .env.example .env
# Edit .env with your API credentials and settings

Run the MCP server.

python mcp_server.py

Additional configuration and notes

The server relies on API keys and credentials to access different services. You typically configure these in an environment file (for example, an .env file). Ensure you provide credentials for Google APIs (calendar and email), a Weather API, a News API, and a Home Assistant instance if you plan to control smart devices.

Available tools

get_events

Retrieve upcoming calendar events from your connected calendar service.

create_event

Schedule a new calendar event with a title, time, and participants.

list_tasks

View all tasks or filter by status to track progress.

add_task

Create a new task with details and due date.

update_task_status

Update a task status to pending, in-progress, or completed.

get_emails

List recent emails from your inbox.

read_email

Read the full content of a specific email.

send_email

Compose and send an email to a recipient.

web_search

Perform a web search and return relevant results.

get_weather

Fetch current weather information for a location.

get_news

Retrieve the latest news articles from configured sources.

list_devices

List all connected smart home devices.

control_device

Control smart home devices such as lights or thermostats.

get_device_state

Get detailed state information for a smart device.

Built by

VeilStrat

AI signals for GTM teams