Skip to content
Back to search

customermates

Open-source CRM to follow up on every client conversation: LinkedIn and email beside each client, dated next steps, MCP for Claude and ChatGPT, self-hostable core.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 13 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/customermates/customermates with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/customermates/customermates'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/customermates--customermates/badge.svg)](/listings/customermates--customermates)

HTML

<a href="/listings/customermates--customermates"><img src="/api/listings/customermates--customermates/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

mkdir customermates && cd customermates
curl -fsSL https://raw.githubusercontent.com/customermates/customermates/main/docker-compose.yml -o docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/customermates/customermates/main/.env.selfhost.template -o .env
# edit .env with real values
docker compose up -d

Required `.env` values:

- `BETTER_AUTH_SECRET`: long random string (`openssl rand -hex 32`). - `POSTGRES_PASSWORD`: change the default. - `BASE_URL`: your public URL (e.g. `https://crm.example.com`). - `RESEND_API_KEY` and `RESEND_OPERATOR_EMAIL`: for signup verification, password reset, and invitation emails.

Optional: uncomment `GOOGLE_CLIENT_ID` and `GOOGLE_CLIENT_SECRET`, or `AZURE_AD_CLIENT_ID` and `AZURE_AD_CLIENT_SECRET`, to offer sign-in with Google or Microsoft. See [Can users sign in with Google or Microsoft?](https://customermates.com/docs/self-hosting#can-users-sign-in-with-google-or-microsoft).

Set `CRON_SECRET` (`openssl rand -hex 32`) and call `/api/cron/lifecycle` daily with it, or Trash is never emptied after 30 days. See [Which scheduled jobs must I run?](https://customermates.com/docs/self-hosting#scheduled-jobs).

First boot takes ~1 minute while Prisma applies migrations. Watch with `docker compose logs -f app`, then open `<BASE_URL>/auth/signup`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 196 lines
  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="public/images/dark/customermates.svg">
  4. <source media="(prefers-color-scheme: light)" srcset="public/images/light/customermates.svg">
  5. <img src="public/images/light/customermates.svg" height="64" alt="Customermates">
  6. </picture>
  7. </p>
  8. <p align="center">Follow up on every client conversation. The open-source CRM with LinkedIn and email beside every client, replies drafted by Mate or your own AI agent through MCP, and self-hosting under the AGPL.</p>
  9. <p align="center">
  10. <a href="https://customermates.com">Website</a> |
  11. <a href="https://demo.customermates.com/en/w/small-business/dashboard">Demo</a> |
  12. <a href="https://customermates.com/docs">Documentation</a> |
  13. <a href="https://github.com/customermates/customermates">GitHub</a> |
  14. <a href="#product-film">Film</a>
  15. </p>
  16. <p align="center">
  17. <a href="https://www.opensourcealternatives.to">
  18. <img src="public/images/brand/open-source-alternatives-badge.svg" alt="As seen on Open Source Alternatives" width="270" height="20" />
  19. </a>
  20. </p>
  21. <p align="center">
  22. <a href="#product-film"><img src=".github/media/customermates-film.webp" alt="Customermates: every client conversation in one place. Follow up on every one." width="1200"></a>
  23. </p>
  24. Customermates helps small teams follow up on every client conversation. LinkedIn and email sit beside each client (on Cloud from Pro also WhatsApp, Instagram and Telegram), and Mate or your own AI agent through MCP drafts each reply and the next step for you to review and send. Underneath is a full CRM for contacts, organizations, deals, services and tasks, with API access, webhooks, n8n automation and MCP.
  25. You can use the managed cloud version or run Customermates yourself in your own infrastructure with Docker Compose.
  26. ## Product film
  27. The 70 second product film shows the workspace: client conversations from email, LinkedIn and WhatsApp in one inbox, Mate drafting the reply and the next step, and the same records open to Claude, ChatGPT or any agent that speaks MCP.
  28. [Watch the film](https://customermates.com/customermates-film.mp4) or find it in this repository at [`public/customermates-film.mp4`](public/customermates-film.mp4).
  29. ## 🚀 Getting Started
  30. There are two ways to start using Customermates:
  31. | Option | Description |
  32. | --- | --- |
  33. | **[Cloud](https://customermates.com)** | Fastest way to get started. Managed by Customermates. |
  34. | **[Self-Hosting](https://customermates.com/docs/self-hosting)** | Run Customermates on your own server with Docker Compose and PostgreSQL. |
  35. Docs entry points:
  36. - [CRM Overview](https://customermates.com/docs)
  37. - [Self-Hosting (install, manage, cloud vs self-host)](https://customermates.com/docs/self-hosting)
  38. - [Connect your AI (Claude)](https://customermates.com/docs/mcp-connect-claude)
  39. - [Webhooks](https://customermates.com/docs/webhooks)
  40. ## ⭐ Key Features
  41. - CRM for contacts, organizations, deals, services, and tasks
  42. - API access with OpenAPI documentation
  43. - Webhooks and event-driven integrations
  44. - n8n workflows and automation support
  45. - MCP support for agent tooling and structured tool calling
  46. - Unified inbox for email, LinkedIn, WhatsApp, Instagram, and Telegram (Cloud, from the Pro plan)
  47. - Audit logging
  48. - Single Sign-On and Whitelabeling on the Enterprise plan (self-hosted Enterprise deployments by agreement)
  49. - Role-based access control for teams
  50. - Several isolated workspaces per login, each with its own data model, members, billing, API keys and MCP connections
  51. - Self-hosted deployment with Docker Compose and PostgreSQL
  52. - Cloud uses monthly per-seat pricing; see the [current plans](https://customermates.com/pricing)
  53. ## 📊 Comparison
  54. Customermates supports both cloud and self-hosted deployment models.
  55. | Criterion | Cloud | Self-Hosted |
  56. | --- | --- | --- |
  57. | Pricing | [monthly per-seat plans](https://customermates.com/pricing) | free core + infra costs |
  58. | Setup Time | 2 minutes | ~15 minutes |
  59. | Maintenance Required | None | Docker, Postgres, proxy, TLS, backups |
  60. | Updates | Automatic | `docker compose pull && docker compose up -d` |
  61. | EU-hosted | ✅ | wherever you put it |
  62. | Backups | Automatic daily | You configure |
  63. | API and integrations | ✅ | ✅ |
  64. | Unlimited Users | ✅ | ✅ |
  65. | Unlimited Records | ✅ | ✅ |
  66. | Several workspaces per login | ✅ (each with its own plan) | ✅ |
  67. | n8n and automation workflows | ✅ | ✅ |
  68. | Unified inbox and calendar sync | from the Pro plan | ❌ (Cloud feature) |
  69. | Audit log | Included | Included |
  70. | Enterprise (SSO, Whitelabeling) | Enterprise plan | By agreement |
  71. If you want the full decision guide, see the [Self-hosting docs](https://customermates.com/docs/self-hosting).
  72. ## 🐳 Self-Hosting
  73. Self-hosting is two files (`docker-compose.yml` and `.env`) plus `docker compose up -d`. No `git clone`, no build step. The published image at `ghcr.io/customermates/customermates:latest` applies pending migrations every time it starts.
  74. ### Prerequisites
  75. - Docker and Docker Compose v2.
  76. - A domain name if you want TLS (optional for local).
  77. - ~2 GB RAM and a couple of GB of disk per thousand records.
  78. ### Setup
  79. ```bash
  80. mkdir customermates && cd customermates
  81. curl -fsSL https://raw.githubusercontent.com/customermates/customermates/main/docker-compose.yml -o docker-compose.yml
  82. curl -fsSL https://raw.githubusercontent.com/customermates/customermates/main/.env.selfhost.template -o .env
  83. # edit .env with real values
  84. docker compose up -d
  85. ```
  86. Required `.env` values:
  87. - `BETTER_AUTH_SECRET`: long random string (`openssl rand -hex 32`).
  88. - `POSTGRES_PASSWORD`: change the default.
  89. - `BASE_URL`: your public URL (e.g. `https://crm.example.com`).
  90. - `RESEND_API_KEY` and `RESEND_OPERATOR_EMAIL`: for signup verification, password reset, and invitation emails.
  91. Optional: uncomment `GOOGLE_CLIENT_ID` and `GOOGLE_CLIENT_SECRET`, or `AZURE_AD_CLIENT_ID` and `AZURE_AD_CLIENT_SECRET`, to offer sign-in with Google or Microsoft. See [Can users sign in with Google or Microsoft?](https://customermates.com/docs/self-hosting#can-users-sign-in-with-google-or-microsoft).
  92. Set `CRON_SECRET` (`openssl rand -hex 32`) and call `/api/cron/lifecycle` daily with it, or Trash is never emptied after 30 days. See [Which scheduled jobs must I run?](https://customermates.com/docs/self-hosting#scheduled-jobs).
  93. First boot takes ~1 minute while Prisma applies migrations. Watch with `docker compose logs -f app`, then open `<BASE_URL>/auth/signup`.
  94. ### Day-to-day
  95. ```bash
  96. docker compose pull && docker compose up -d # update
  97. docker compose up -d # apply .env changes
  98. docker compose logs -f app # logs
  99. ```
  100. Front the app with a reverse proxy (Caddy, nginx, Traefik) for TLS and set `BASE_URL` to the public `https://` address. Customermates takes the scheme and host for its links from `BASE_URL` and sets secure cookies when it uses `https://`, so `X-Forwarded-Proto` is not required. The proxy must pass on the original `Host` header, because the app rejects form submissions whose origin does not match it, including sign-in and sign-up.
  101. More docs:
  102. - [Self-Hosting (install and manage)](https://customermates.com/docs/self-hosting)
  103. - [Architecture and security](https://customermates.com/docs/architecture-security)
  104. ## 🛠️ Development
  105. Create an isolated worktree and run Customermates locally:
  106. ```bash
  107. git fetch origin main
  108. git worktree add ../customermates-my-change -b feat/my-change origin/main
  109. cd ../customermates-my-change
  110. nvm use
  111. yarn db:provision
  112. cp .env.cloud.template .env
  113. # Paste the printed DATABASE_URL and DIRECT_URL into .env.
  114. yarn install --frozen-lockfile
  115. yarn db:reset
  116. yarn dev
  117. ```
  118. `yarn db:provision` creates a PostgreSQL 17 container and named volume owned by the current worktree. Re-running it is idempotent. `yarn db:reset` applies the migrations, seeds the database, and prepares the workflow schemas. Replacing the database volume is destructive and only happens with `yarn db:provision --recreate`; use `yarn db:provision --destroy` to remove the worktree's owned database when the worktree is retired.
  119. Useful scripts:
  120. - `yarn dev`
  121. - `yarn build`
  122. - `yarn lint`
  123. - `yarn openapi:generate`
  124. - `yarn db:provision`
  125. - `yarn db:reset`
  126. For configurable CRM architecture review, isolated databases, production-build browser journeys and SSH verification, see [the browser verification guide](tests/e2e/README.md).
  127. ## 📚 Documentation
  128. The docs cover:
  129. - product overview and CRM comparison
  130. - self-hosting and operations
  131. - API integrations and OpenAPI
  132. - MCP and n8n
  133. - architecture and security
  134. Start here: [customermates.com/docs](https://customermates.com/docs)
  135. ## 📄 License
  136. Customermates uses an open-core licensing model, described in [`LICENSING.md`](./LICENSING.md).
  137. The Community Edition (all first-party code outside `ee/`) is licensed under [AGPL-3.0-only](./LICENSE).
  138. Other first-party files in `ee/` are source-available under the [Customermates Commercial License](./ee/LICENSE.md), subject to its AGPL client-material exception. Production use of Commercial Software outside the limited Community Build permission, including any Enterprise Feature, requires a Commercial Agreement.
  139. The official Community image at `ghcr.io/customermates/customermates` is built from the shared codebase and contains compiled Commercial Software. The limited Community Build permission allows anyone to run its unmodified commercial support components where documented `APP_MODE=self-hosted` operation necessarily executes them; it does not license Enterprise Feature use.
  140. Contributor terms are available in [`.github/CLA.md`](./.github/CLA.md).
  141. Third-party data keeps its own license: the address formats from Google libaddressinput that ship with Customermates and the postal codes it downloads from GeoNames are licensed under CC BY 4.0, see [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.