Stefan Lohmaier
c06e6d6b4c
Notes server rewritten to use Joplin CLI Data API (joplin-cli sync clients on host, ports 41184/41185). Clean fast search, proper resource handling. New tools: list_note_resources, read_resource (attachments as inline image/document/text). Mail server: read_mail now lists attachments; new read_attachment tool returns images inline, PDFs/docs as EmbeddedResource, text directly. Tests: 54 total. Notes now real (notebooks, list, create+read). Mail attachment listing + fetch tested. 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