# mcp-home

Self-hosted [MCP](https://modelcontextprotocol.io) servers for Claude. Gives Claude access to your email, calendar, contacts, files, and notes — all running on your own hardware.

## Services

- **Mail** — search and read emails from IMAP backups (Maildir format)
- **Calendar + Tasks** — read/write events and reminders via CalDAV (Radicale)
- **Contacts** — search/read/write contacts via CardDAV (Radicale)
- **Files** — browse and read files via WebDAV (oCIS)
- **Notes** — search/read/write notes via Joplin API

## Setup

```bash
python3 -m venv venv
venv/bin/pip install mcp[cli] httpx vobject python-dateutil
```

Copy `tokens.json.example` to `tokens.json` and set client secrets.

## Usage with claude.ai

Add as Custom MCP Server in claude.ai Settings → Integrations:

- **URL**: `https://your-domain/mail/mcp` (or calendar, contacts, files, notes)
- **OAuth Client ID**: your username
- **OAuth Client Secret**: your secret from tokens.json

## License

MIT