mcp-personal-suite

Preis auf Anfrage

> Part of the StudioMeyer MCP Stack — Built in Mallorca 🌴 · ⭐ if you use it mcp-personal-suite Local-first personal productivity MCP server. 49 tools. BYOK. No cloud. No signup. Email, Calendar, Messaging, Search, Image Generation — all in one MCP server, running entirely on your machine. Works with Claude Desktop, Claude Code, Cursor, and any MCP client. Quick Start · Modules · Config · Privacy · Security · ECOSYSTEM A note from us We have been building tools and systems for ourselves for the past two years. The fact that this repo is small and has few stars is not because it is new. It is because we only just decided to share what we have built. It is not a fresh experiment, it is a long story with a recent commit. We love building things and sharing them. We do not love social media tactics, growth hacks, or chasing stars and followers. So this repo is small. The code is real, it gets used, issues get answered. Judge for yourself. If it helps you, sharing, testing, and feedback help us. If it could be better, an issue is more useful. If you build something with it, tell us at hello@studiomeyer.io. That genuinely makes our day. From a small studio in Palma de Mallorca. Why Managing email, calendar, messaging, search, and image generation from an AI assistant usually means five to six separate MCP servers, each with its own install, OAuth dance, and API keys. This bundles all of it into one server that runs on your laptop. Everything stays local. Your credentials live in /.personal-suite/config.json with 0600 permissions and AES-256-GCM encryption at rest. The only data that ever leaves your machine is the direct API call to the provider you configured. No signup, no backend, no tenant database. Bring your own keys (BYOK) for Brave, Exa, Tavily, OpenAI, Gemini, and so on. Messaging uses your own bot tokens (BotFather for Telegram, Discord developer portal, Slack app, etc.). Email uses Gmail/Outlook OAuth or plain IMAP with auto-discovery for 30,000+ providers. Quick Start Then in chat: First-time setup wizard (optional, for Google OAuth): 49 Tools, 6 Modules Email — email (15 tools) Gmail OAuth2, Outlook OAuth2, generic IMAP/SMTP. Auto-discovery for 30K+ providers (Gmail, Outlook, Yahoo, iCloud, WEB.DE, GMX, T-Online, mailbox.org, Posteo, IONOS, Strato, Fastmail, ProtonMail Bridge, and many more). Attachments up to 25 MB with path-traversal protection. Calendar — calendar (11 tools) Google Calendar (OAuth2) plus CalDAV (Apple iCloud, Nextcloud, mailbox.org, Posteo, Radicale, any CalDAV server). Events, availability, conflict detection, Meet links, daily summaries. Provider-transparent: same tools for both. Messaging — channel (8 tools) Telegram (grammy), Discord (discord.js), Slack (@slack/bolt), WhatsApp (Baileys). Bring your own bot tokens. Send, receive, broadcast, history. > Heads-up on WhatsApp: Baileys is an unofficial reverse-engineered client. > It works but carries supply-chain risk and can break whenever WhatsApp changes > its protocol. For anything production-critical, use the official > WhatsApp Business API (WABA) > instead. Baileys is fine for personal/tinkering use. Search — search (7 tools) Multi-provider gateway (BYOK): SearXNG (self-hosted), Brave, Exa (neural), Tavily (research with citations). Web, news, images, deep research, semantic, code context. Image — image (3 tools) BYOK image generation: OpenAI DALL-E 3, Flux via fal.ai (photorealistic), Google Gemini Imagen 3 (product shots). Auto-routing by prompt type. System — suite (5 tools) Onboarding, status, setup wizard, health checks, embedded documentation, GDPR delete (per-module or complete wipe). Config Credentials live in a single JSON file: - macOS / Linux: /.personal-suite/config.json - Windows: %USERPROFILE%\.personal-suite\config.json Permissions are forced to 0600 (owner read/write only). Sensitive fields (passwords, tokens, secrets, API keys) are encrypted with AES-256-GCM before being written. The encryption key is auto-generated in /.personal-suite/.key on first run, or you can provide your own via the CREDENTIALENCRYPTIONKEY environment variable (32 bytes, base64). Nothing ever leaves your machine except the direct API calls you make to the providers you explicitly configure. Privacy - No signup, no account, no telemetry. - No outbound requests until you configure a module. - Credentials encrypted at rest, file mode 0600. - suitedelete(module: "all", confirm: true) wipes everything. - MIT licensed. Read the source. Fork it if you want. Development HTTP Transport (self-hosted) If you want a long-running server for multiple clients on your LAN: Point your MCP client at http://localhost:5120/mcp. Streamable HTTP with session management. Bind behind your own reverse proxy if you expose it beyond localhost. Security defaults (HTTP mode): - MCPALLOWEDORIGINS — comma-separated origin whitelist for browser-based MCP clients. Unset means no cross-origin requests accepted (safest). Example: MCPALLOWEDORIGINS=http://localhost:3000,https://my-client.example.com. - MCPMAXSESSIONS — cap on concurrent sessions (default 100). Returns 503 Retry-After: 60 beyond the limit. - MCPHOST — bind address (default 127.0.0.1). Change to 0.0.0.0 only if you actually want to expose the server on the network. Docker Tech - TypeScript strict, no any, no circular deps - @modelcontextprotocol/sdk@^1.26.0 - imapflow (async IMAP with auto-reconnect), nodemailer (SMTP) - googleapis (Gmail + Calendar OAuth) - ts-caldav (Apple iCloud, Nextcloud, Radicale) - grammy, discord.js, @slack/bolt, @whiskeysockets/baileys - vitest for tests, stdio + Streamable HTTP dual transport Related - local-memory-mcp — persistent local memory for Claude, Cursor, Codex. Pairs nicely with this. - mcp-video — cinema-grade video production (ffmpeg + Playwright). - agent-fleet — multi-agent orchestration for Claude Code. - ai-shield — LLM security for TypeScript (prompt injection, PII, cost control). - darwin-agents — self-evolving prompts via A/B testing. About StudioMeyer StudioMeyer is an AI and design studio based in Palma de Mallorca, working with clients worldwide. We build custom websites and AI infrastructure for small and medium businesses. Production stack on Claude Agent SDK, MCP and n8n, with Sentry, Langfuse and LangGraph for observability and an in-house guard layer. License MIT. Built by StudioMeyer.