Sessy – Amazon SES Observability

Amazon SES is a fantastic email service: cost-effective, reliable, and great deliverability. But it's frustratingly difficult to see what's actually happening with your emails.

That's why many people turn to overpriced email services that are often just glorified SES wrappers with a nice UI. You end up paying a lot for something you could do yourself.

Sessy is the open-source alternative. Use raw SES and still get a beautiful interface to see what happens after you hit send: deliveries, bounces, complaints, opens, clicks, and more.

The easiest way to run Sessy is with Docker:

docker run -p 80:80 \ -e SECRET_KEY_BASE=$(openssl rand -hex 64) \ -e DISABLE_SSL=true \ -v sessy:/rails/storage \ ghcr.io/marckohlbrugge/sessy:main

Create an API key on theAPI keyspage in the web UI, then follow the connect instructions at/docs/mcpon your instance. For example, for Claude Code:

claude mcp add --transport http sessy https://your-sessy-host/mcp \ --header "Authorization: Bearer YOUR_API_KEY"

- Cloudflare / CDN users:bot protection (managed challenges) blocks MCP clients. Exempt the/mcppath from bot protection or agent requests will fail.
- HTTP Basic auth:/mcpauthenticates with API keys only and ignoresHTTP_AUTH_*. Enabling HTTP Basic later does not revoke previously created API keys — review the API keys page after locking down an install.

We're working on a managed version of Sessy for those who'd rather not run their own instance.

You'll notice references to it in this codebase: asaas/directory,Gemfile.saas, and the occasionalSessy.saas?check. These power the hosted version and are intentionally kept in this repository for simplicity, rather than maintaining separate repos. None of it affects self-hosting: the default bundle ignores thesaas/engine entirely, and the test suite verifies the open-source version behaves identically without it.

You are welcome to modify Sessy to your liking.

We welcome contributions! Since we're still in a very early stage, please keep the following in mind:

- Typos and obvious bugs:Feel free to submit a PR directly.
- Code changes:Please try to match our existing style.
- New features:Please open an issue first to discuss before implementing.
- Deployment docs:We keep first-party deployment docs focused on broad, open, self-hosted paths we actively use (for example Docker, Kamal, and Dokku). We generally do not add provider-specific deployment guides to this repository.

For anything beyond small fixes, please open an issue first so no one wastes their time on something we might not merge.

Send emails using AWS Simple Email Service (SES). Supports plain text, HTML, CC, BCC, reply-to, and email scheduling.

Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.

Turn AI tools into your email marketing assistant.

Turn an AI tool into your smart email engine

Connect your AI assistant to Onboard to monitor live onboarding projects, surface blocked tasks and risks, draft customer emails, and take action on tasks with role-based access and preview-first safety.

Send and receive emails, SMS, and voice calls via Pingram.

Send emails directly from your editor using the Resend API.