Stefan Lohmaier
fb642e47c8
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>
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