@lcapps/mcp-crm

Connect your LCApps CRM with Claude and other AI assistants.

Which of the two ways you need

There are two ways to connect, and most people want the first one.

Start with the connector. If later you need invoices and budgets to be saved as files, come back here.

Related MCP server: capsulemcp

Connect without installing anything

You need the address of your CRM. It's the usual one, changing the beginning to mcp:

The steps:

1. Open Claude and go to its settings.

2. Find the connectors section and choose to add a custom one.

3. Paste the address from the table and save.

4. Claude will open your CRM in the browser so you can log in and authorize. It's your usual session, with your user.

5. Review what it asks and accept.

That's it. Ask it about your clients, your invoices, or your expenses.

If something doesn't work

You will only see what your user can see in the CRM. Connecting does not grant new permissions.

Save documents on your computer

For this, you do need this package. A regular connector cannot write to your disk, so a PDF arrives inside the response and stays there.

This program runs on your computer, forwards the conversation to the server, and saves any files that arrive, leaving Claude the path where they ended up.

You need Node.js installed. Then, in your client's configuration:

{
  "mcpServers": {
    "lcrm-int": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp-int.lcrm.es/mcp" }
    },
    "lcrm-test": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp-test.lcrm.es/mcp" }
    },
    "lcrm": {
      "command": "npx",
      "args": ["-y", "@lcapps/mcp-crm"],
      "env": { "LCRM_MCP_URL": "https://mcp.lcrm.es/mcp" }
    }
  }
}

All three entries can be active at the same time. Credentials are saved per server, so authorizing one does not log out the others.

Where the configuration file is:

• Claude Desktop on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Claude Desktop on Windows: %APPDATA%\Claude\claude_desktop_config.json

• Cursor: in its MCP settings

--url https://…/mcp serves as an alternative to the environment variable.

Authorization

The first time, the browser opens so you can authorize access. The package registers as an OAuth client, waits for the response at http://localhost:33420/callback, and saves the credentials in ~/.lcrm/credentials/<server>.json with permissions 0600. After that, it reuses the refresh token, so the browser only appears once per server.

You can also launch it manually:

LCRM_MCP_URL=https://mcp.lcrm.es/mcp npx -y @lcapps/mcp-crm login
LCRM_MCP_URL=https://mcp.lcrm.es/mcp npx -y @lcapps/mcp-crm logout

Where the files end up

The documents returned by the CRM are saved in ~/Downloads/lcrm-mcp/ and the assistant receives the path. The name comes from the CRM itself —budget_26_010.pdf and the like— reduced to a single safe segment: the server does not decide where it is written. An existing file is never overwritten; a suffix -1, -2 is added.

Environment variables

Changing the port changes the return address, so you will need to authorize again.

Development

npm install
npm run typecheck
npm test
npm run build

License

MIT — see LICENSE.