slohmaier/mcp-home
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
6 Commits 1 Branch 0 Tags
1f98695821ca9fcc4a4e44453a87b23af5216a18
T
Clone
Open with VS Code Open with VSCodium Open with Intellij IDEA
Download ZIP Download TAR.GZ Download BUNDLE
Stefan Lohmaier 1f98695821 Add create_draft tool to Mail server 
Creates email drafts via IMAP APPEND to the Drafts folder.
Supports Stefan (1blu, Drafts folder) and Kati (Gmail, Entwürfe).
Draft can be reviewed and sent from Roundcube or phone.

IMAP credentials externalized to config.json.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-06-12 08:16:53 +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
Add write_file, create_folder, delete_file, move_file to Files server
2026-06-12 08:08:08 +02:00
mail
Add create_draft tool to Mail server
2026-06-12 08:16:53 +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

Reference in New Issue View Git Blame Copy Permalink
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%