The open-source AI engine behind a business: connect your channels and accounts, and Moharrik watches (notifications, trends, research), acts (automation), talks to customers (chat, email, WhatsApp) and remembers them (CRM). Every capability is an MCP tool, so your AI agents can do it too.
Website · Architecture · Discord · Discussions · Issues
- Unified inbox: website chat widget, email mailboxes and WhatsApp conversations in one place, with labels, assignment, snoozing and canned replies. Alerts can go to Slack, Telegram and Discord.
- CRM: contacts, companies, deals on a pipeline, activities and timelines. Includes vCard and CSV import/export and Google Contacts sync.
- Leads: embeddable inquiry forms that capture UTM and click IDs. One click converts a lead into a contact, a company and a deal.
- Email marketing: lists with per-list double opt-in, campaigns, templates and per-workspace SMTP. Includes RFC 8058 one-click unsubscribe.
- Automation: rules and workflows, plus a browser extension that records and replays steps from a library of preset automations. Steps that publish or send are always marked.
- Watch the world: a notification center, trend sources, scheduled research and prospect discovery, plus Google Search Console, GA4 and YouTube analytics.
- AI agents over MCP: a workspace MCP server with explicit scopes (no wildcards). Tokens are narrowed to the user's current role on every call, so Claude, ChatGPT and friends work under the same permissions as a person. OAuth connectors are included.
- Multi-tenant and secure by default: workspaces with owner/admin/manager/member/client roles, default-deny routes, and Postgres row-level security on every tenant table.
- Bilingual: English and Arabic (RTL), light and dark.
To try Moharrik without installing anything, use the hosted version at moharrik.com. Sign up, create a workspace and connect a channel.
Requirements: Docker with Compose v2.
git clone https://github.com/fadymondy/moharrik.git && cd moharrik
cp .env.selfhost.example .env.selfhost
# fill in POSTGRES_PASSWORD, MOHARRIK_APP_DB_PASSWORD and AUTH_SECRET
# (generate each with: openssl rand -hex 32)
docker compose -f docker-compose.selfhost.yml --env-file .env.selfhost up -d --buildOpen http://localhost:3000, register and create a workspace. The stack runs Postgres 17 and a one-shot migration job. A single app container serves the Go API and the Next.js web on one port. For a public deployment:
- put a TLS reverse proxy in front;
- set
APP_URLto the public origin; - set
COOKIE_SECURE=1.
Every other setting is documented in .env.example: mail, AI providers, research,
Google, push notifications and the CircleXO app store.
To make yourself a platform admin (for the admin MCP server):
docker compose -f docker-compose.selfhost.yml --env-file .env.selfhost exec app /app/bin/moharrik-admin promote you@example.comSee CONTRIBUTING.md and the "Run it" section of docs/architecture.md.
browser · chat widget · browser extension · MCP clients
│ one origin: /api, /graphql, /api/mcp, pages
┌─────────────▼──────────────────────────────────────────────┐
│ Go API (ToGO: chi + Huma REST + gqlgen + sqlc) │
│ default-deny guard → tenant scope → authz → handlers │
│ inbox · CRM · leads · marketing · automation · research │
│ MCP (user + admin) · background workers │
│ proxies every other path to Next.js (same container) │
└──────────────┬─────────────────────────────────────────────┘
│ owner pool + RLS app pool (moharrik_app)
┌──────▼───────┐
│ PostgreSQL │ FORCE row-level security per workspace
└──────────────┘
| Path | What |
|---|---|
cmd/api, cmd/migrate, cmd/moharrik-admin |
API (and worker), migrator, platform admin CLI |
internal/server, internal/tenant, internal/authz |
Default-deny guard, workspace scope and RLS pool, permissions |
internal/inbox, internal/channels, internal/whatsapp |
Conversations and channels |
internal/crm, internal/contacts, internal/leads |
CRM and leads |
internal/marketing |
Lists, campaigns, double opt-in, SMTP |
internal/automation, internal/rules, extension/ |
Automation, rules and the browser extension |
internal/research, internal/trends, internal/notifications |
Research, trends, notification center |
internal/mcp |
User and admin MCP servers, OAuth |
internal/db/schema, internal/db/post |
Schema and post-migration SQL (RLS, roles, constraints) |
web/ |
Next.js app (en/ar) |
The engineering notebook in docs/architecture.md covers tenancy and RLS, MCP, the modules and framework notes.
Moharrik is built on ToGO (GitHub), the open-source, API-first framework for Go + sqlc + Atlas + GraphQL/OpenAPI + Next.js with a Laravel-style CLI. The kernel is small and everything else is a plugin; these are the pieces Moharrik uses:
| ToGO piece | What it does in Moharrik |
|---|---|
| Kernel | Config, the hook/event bus, the plugin registry and server bootstrap |
| CLI | togo generate (sqlc → gqlgen → Atlas → OpenAPI), migrations, togo serve |
| auth | Sign-in, JWT sessions, roles and API tokens |
| orm | Query building in the domain services |
| validation | Laravel-style request validation |
| ratelimit | Throttling for the API, webhooks and MCP |
| queue · cache · storage · realtime · i18n | Background jobs, caching, attachments, live updates and EN/AR |
| db-postgres | The Postgres driver |
| faker | Factories and seed data for tests |
Want the same foundation for your own app? Run go install github.com/togo-framework/cli@latest && togo new myapp,
then read the ToGO docs and browse the plugin marketplace.
Read the case study: Multi-tenant Postgres RLS in Go: Moharrik on ToGO.
- Architecture and engineering notes
- MCP agent provider · CircleXO integration
- API reference: run the API and open
/docs(OpenAPI)
Bug reports, docs and code contributions are all welcome. Start with
CONTRIBUTING.md, which covers setup, conventions and the DCO sign-off. Then look
for a good first issue. AI
coding agents should start with AGENTS.md.
- Discord: chat with the team and other users
- GitHub Discussions: questions, ideas, show and tell
- Issues: bugs and feature requests
- Security reports: see SECURITY.md
Please follow the Code of Conduct.
Moharrik is built on ToGO, the open-source Go + React framework that powers this whole family of apps. The best way to support Moharrik is to sponsor ToGO: every sponsorship goes into the framework and the apps built on it.
Copyright (C) 2026 Fady Mondy. Moharrik is free software, licensed under the GNU Affero General Public License v3.0. If you run a modified version as a network service, you must offer its source to your users. Third-party components keep their own licenses.
Commercial licensing available: for a license without the AGPL obligations, contact info@3x1.io.