# Acme CRM example

> Acme CRM example is an open-source MCP server for sales and crm. Example MCP-compatible CLI for a fake CRM with synthetic data, for developers. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/leemour/acme-crm-cli
- **MCP Registry name:** io.github.leemour/acme-crm-cli
- **Categories:** [sales and CRM](https://ai-powered.com/categories/sales-and-crm), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README says this is a demonstration rather than a working CRM client. With ACME_CRM_BASE_URL unset, it answers from a built-in fake holding synthetic data: 10 organizations, 25 people, 15 deals and 8 invoices, all with made-up names and example.com addresses.

Its main purpose is to show how a third-party tool plugs into WireCat. It covers sign-in with a session token kept in the OS keyring, a sync command that copies organizations, people and deals, and read commands for deals and contacts with JSON output. It also ships a WireCat manifest, an MCP server and an agent skill.

It suits developers who want a reference implementation for building a WireCat-compatible tool, not anyone who needs to manage a real CRM.

## Features

- **Built-in synthetic CRM:** Runs against a fake dataset of organizations, people, deals and invoices when no base URL is set.
- **Session sign-in:** Signs a named profile in with a token stored in the OS keyring.
- **Sync command:** Copies organizations, people and deals and imports invoices as proposals the owner confirms.
- **Read commands with JSON output:** Lists and shows deals and contacts, with field selection for JSON output.
- **WireCat manifest and MCP server:** Includes a contracts/wirecat.json manifest, an MCP server and an agent skill.

## Good for

- Learning how to build a WireCat-compatible CLI tool
- Testing agent workflows against a fake CRM with no real data
- Reviewing a reference layout for CLI, MCP server and agent skill packaging

## Install

### Claude Code (Terminal)

```sh
claude mcp add acme-crm-cli -- npx -y @leemour/acme-crm-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "acme-crm-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@leemour/acme-crm-cli"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "acme-crm-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@leemour/acme-crm-cli"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "acme-crm-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@leemour/acme-crm-cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "acme-crm-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@leemour/acme-crm-cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "acme-crm-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@leemour/acme-crm-cli"
      ]
    }
  }
}
```

## FAQ

### Does it connect to a real CRM?

Not by default. With ACME_CRM_BASE_URL unset, it uses a built-in fake dataset. The README describes Acme CRM as a service that does not exist.

### How do I sign in?

Run acme-crm personal session start. The fake accepts any token beginning with acme_test_, such as acme_test_demo.

### How is it installed?

The README gives the install command npm install -g @leemour/acme-crm-cli.

### Is Acme CRM example free?

Yes. Acme CRM example is open source, so you can use and self-host it for free.

### How do I add Acme CRM example to Claude Code?

Run this command in your terminal: claude mcp add acme-crm-cli -- npx -y @leemour/acme-crm-cli

### What are the best alternatives to Acme CRM example?

The closest alternatives to Acme CRM example are WireCat amo, webCRM MCP by usefulapi, Cirqll MCP by usefulapi, Hermit CRM and Revamp CRM MCP by usefulapi.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [WireCat amo](https://ai-powered.com/mcp/wirecat-amo): WireCat amo is an open-source MCP server for sales and crm.
- [webCRM MCP by usefulapi](https://ai-powered.com/mcp/webcrm-mcp-by-usefulapi): webCRM MCP by usefulapi is a freemium MCP server for sales and crm.
- [Cirqll MCP by usefulapi](https://ai-powered.com/mcp/cirqll-mcp-by-usefulapi): Cirqll MCP by usefulapi is a freemium MCP server for sales and crm.
- [Hermit CRM](https://ai-powered.com/mcp/hermit-crm): Hermit CRM is an open-source MCP server for sales and crm.
- [Revamp CRM MCP by usefulapi](https://ai-powered.com/mcp/revamp-crm-mcp-by-usefulapi): Revamp CRM MCP by usefulapi is a freemium MCP server for sales and crm.
- [The-Y CRM](https://ai-powered.com/mcp/the-y-crm): The-Y CRM is a freemium MCP server for communication.
- [Api Test MCP](https://ai-powered.com/mcp/api-test-mcp): Api Test MCP is an open-source MCP server for developer tools.
- [Customermates](https://ai-powered.com/mcp/customermates): Customermates is a freemium MCP server for sales and crm.

---
Source: https://ai-powered.com/mcp/acme-crm-example
