AGH Mail MCP Server

A small [MCP] server that lets Claude read and send email from your AGH mailbox (poczta.agh.edu.pl)

Ask Claude things like "any new emails" or "reply to the professor saying I'll attend"

Status: Local use with Claude Desktop is fully supported and is what this README covers. Remote hosting (so it works in the Claude mobile/web app or Cowork) is not supported yet.

Tools exposed

Prerequisites

• Python 3.10 or newer

• An AGH mailbox at poczta.agh.edu.pl

• Claude Desktop installed

Setup

Step 1 - Generate an AGH app password

1. Log into https://poczta.agh.edu.pl

2. Go to Ustawienia → Hasła do aplikacji

3. Enter your password to authorize, give the new password a name

4. Copy the generated password (you'll only see it once)

Step 2 - Clone and install

git clone https://github.com/Nikodem5/agh-mcp.git
cd agh-mcp
python -m venv .venv
(activate the virtual environment)
pip install -r requirements.txt

Step 3 - Configure your credentials

Copy the example file and fill in your two values:

cp .env.example .env        # Windows PowerShell: Copy-Item .env.example .env

Edit .env:

AGH_EMAIL=123456@student.agh.edu.pl
AGH_APP_PASS=the_app_password_from_step_1

Step 4 - Connect it to Claude Desktop

Open your Claude Desktop config file (create it if it doesn't exist):

Add an entry pointing at the absolute path to server.py

{
  "mcpServers": {
    "agh-mail": {
      "command": "python",
      "args": ["/absolute/path/to/agh-mcp/server.py"]
    }
  }
}

Fully quit and reopen Claude Desktop.

Extending: "university agent" ideas

This is a foundation. Each new capability is just one Python function with an @mcp.tool() decorator. Ideas:

• get_calendar — pull your AGH timetable from USOS

• check_grades — watch USOS for new grade entries

• get_deadlines — parse the UPeL e-learning platform for upcoming deadlines

• search_library — query the AGH library catalog

Project structure

agh-mcp/
├── server.py                        # the MCP server (all tools live here)
├── requirements.txt                 # mcp + python-dotenv
├── .env.example                     # template — copy to .env and fill in
├── .env                             # your secrets (git-ignored, never committed)
├── .gitignore
├── cowork-skill-morning-briefing.md # optional daily-digest skill
└── README.md