Kelpie Cloud is coming soon. Self-host Kelpie for free today →

Free · AGPL-3.0

Run Kelpie on your own servers

The Kelpie core is open source. Self-host it for free, with no record limits. You get the same CRM, API, and MCP server as Kelpie Cloud.

Install instructions View on GitHub

Install

You do not need to clone the repository. The scaffolder makes a new project in an empty directory.

  1. Make the project

    npm create kelpie@latest

  2. Install and start Postgres

    cd kelpie
npm install
docker compose up --detach --wait

    Do you already have Postgres? Skip the Docker step.

  3. Start Kelpie

    npm run dev

    Open http://localhost:5173/signup and make your workspace. Migrations apply when the server starts.

Set it up with an agent

Claude Code, Cursor, Codex, or another coding agent can install Kelpie for you. Open your agent in an empty directory and give it this prompt.

Setup prompt 
Set up a new Kelpie CRM project. Run `npm create kelpie@latest -- my-crm --yes` in an empty directory, then `cd my-crm && npm install`. If there is a `docker-compose.yml`, run `docker compose up --detach --wait`. Run `npm run dev` and confirm it is healthy: `http://localhost:5173/healthz` must return `{"status":"ok","database":"up"}`. Then tell me to open `http://localhost:5173/signup` to create my account and workspace. Report the result.

After the setup, connect your agent to Kelpie over MCP, and give it the Kelpie skill so it knows how to use the CRM. Connect an agent →

Self-host or Kelpie Cloud?

The two use the same core. The difference is who runs it.

Topic Self-host Kelpie Cloud
Price Free Free plan, then from $29 per workspace per month
Records No limit Limit set by your plan
Hosting, backups, upgrades You do them We do them
AI Your own OpenAI or Anthropic key, or your own agent Hosted Kelpie AI on Team and Business, or your own agent
API and MCP Yes Yes
Email Your own SMTP server Included
Integrations (eg Resend, Mailchimp, Slack) — Yes
Support Community, on GitHub Email and priority support on paid plans
Join the waitlist See pricing

Learn more

README and docs

Configuration, upgrades, email, and how to connect an agent.

Source on GitHub

Read the code, report issues, and contribute.

create-kelpie on npm

The scaffolder and all its flags.

Kelpie is licensed under AGPL-3.0. If you change Kelpie and let other people use it over a network, you must share your changes under the same licence.