T

Stefan Lohmaier b88adc4c50 read_file: pass binary documents as EmbeddedResource

PDF, docx, xlsx, pptx etc. are returned as EmbeddedResource with
BlobResourceContents (base64 + mimeType). claude.ai processes these
client-side, same as Google Drive/Dropbox MCP connectors.

Fallback chain: text → image → embedded resource (binary).
MIME type guessed from extension when server returns octet-stream.

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

2026-06-12 08:02:32 +02:00

calendar

Add travel time, geocoding, and reminders to create_event

2026-06-12 07:28:00 +02:00

contacts

Add image support to Files and contact photos to Contacts

2026-06-12 07:53:55 +02:00

files

read_file: pass binary documents as EmbeddedResource

2026-06-12 08:02:32 +02:00

mail

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

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

notes

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

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

.gitignore

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

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

CLAUDE.md

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

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

common.py

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

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

config.json.example

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

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

README.md

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

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

tokens.json.example

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

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

README.md

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