Stefan Lohmaier
30351f1bcf
URLs: mail.mcp.home.slohmaier.de, calendar.mcp..., etc. No more path-prefix routing — each service has its own domain. OAuth tokens stored in shared .active_tokens.json file so all services can validate tokens issued by any service. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
mcp-home
Self-hosted MCP 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
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