slohmaier/mcp-home

Files

T

Stefan Lohmaier fb642e47c8 Initial commit: 5 MCP servers for Mail, Calendar, Contacts, Files, Notes

Self-hosted MCP servers with OAuth client_credentials auth.
Each server connects to a different backend:
- Mail: reads Maildir IMAP backups
- Calendar/Tasks: CalDAV against Radicale
- Contacts: CardDAV against Radicale
- Files: WebDAV against oCIS
- Notes: Joplin REST API

Credentials externalized to config.json (not in repo).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-06-12 06:22:42 +02:00

996 B

Raw Blame History

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