Stefan Lohmaier a9359beead Add image support to Files and contact photos to Contacts
Files:
- read_file returns images inline (jpg/png/gif/webp up to 10MB)
- Text files returned as text, binary files as metadata only

Contacts:
- get_contact includes contact photo as inline image if available
- New tool: set_contact_photo (base64 jpeg/png → VCard PHOTO)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-06-12 07:53:55 +02:00

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

S
Description
Self-hosted MCP servers for Claude — Mail, Calendar, Contacts, Files, Notes via CalDAV/CardDAV/WebDAV/IMAP
Readme 345 KiB
Languages
Python 99.1%
Shell 0.9%