Stefan Lohmaier
e721250552
Test collections: calendar-test, contacts-test, /mcp-tests/ - OAuth: 30 tests (metadata, credentials, PKCE, rejection, tools list × 5 servers) - Mail: 5 tests (accounts, folders, search, empty search, read full mail) - Calendar: 5 tests (list, tasks, create event + verify, create task + verify, date range) - Contacts: 4 tests (search, empty, create + verify, get details) - Files: 6 tests (list, info, write+read+delete, create+delete folder, move, search) - Notes: 1 test (list notebooks) All tests create unique timestamped data and clean up after themselves. 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