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>

README.md

@@ -0,0 +1,32 @@
+# 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