# VTENext CRM

> VTENext CRM is an open-source MCP server for sales and crm. MCP server giving Claude and other MCP clients access to VTENext CRM opportunities. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted, Linux, macOS, Windows
- **Website:** https://www.castaldosolutions.it/articles/en/blog/mcp-server-vtenext-crm-claude
- **Repository:** https://github.com/castaldo-solutions/mcp-vtenext
- **MCP Registry name:** it.castaldosolutions/mcp-vtenext
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-18

## About

The README says this server wraps the VTENext WebService API so that an AI assistant can read and, optionally, write CRM records. It covers opportunities (called potentials in vtiger-based systems), contacts, notes, and activities linked to a deal, plus a field describer and a raw VTQL SELECT tool for exploration.

Configuration is done through environment variables for the instance URL, a username and an access key. The access key is generated per user in VTENext under Admin, Users. Setting READ_ONLY to true blocks the three write tools, which is useful for bots that should only report on pipeline data. Sessions are cached for a few minutes to avoid repeated logins.

It suits teams that run a self-hosted VTENext instance and already use Claude Desktop or Claude Code, and developers who want a base to extend with further modules. It runs locally over stdio and is published under the MIT licence.

## Features

- **Opportunity management:** List, search, fetch, create and update opportunities with status, amount and notes.
- **Contact search:** Find contacts by name, email or company.
- **Activity and note access:** Read activities linked to a deal and add comments to an opportunity.
- **Read-only mode:** A READ_ONLY setting blocks every write tool for safer automated use.
- **Raw VTQL queries:** Run arbitrary VTQL SELECT statements for exploration and debugging.
- **Module field discovery:** Describe the available fields of any VTENext module.

## Good for

- Asking an AI assistant which deals are in a given sales phase
- Adding a call note to an opportunity from a chat window
- Running a read-only pipeline report bot against a CRM
- Looking up contact details by company name during a conversation
- Building a custom integration on top of VTENext's WebService API

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-vtenext --env VTENEXT_URL='<VTENEXT_URL>' --env VTENEXT_USERNAME='<VTENEXT_USERNAME>' --env VTENEXT_ACCESS_KEY='<VTENEXT_ACCESS_KEY>' -- npx -y @castaldosolutions/mcp-vtenext
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-vtenext": {
      "command": "npx",
      "args": [
        "-y",
        "@castaldosolutions/mcp-vtenext"
      ],
      "env": {
        "VTENEXT_URL": "<VTENEXT_URL>",
        "VTENEXT_USERNAME": "<VTENEXT_USERNAME>",
        "VTENEXT_ACCESS_KEY": "<VTENEXT_ACCESS_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-vtenext": {
      "command": "npx",
      "args": [
        "-y",
        "@castaldosolutions/mcp-vtenext"
      ],
      "env": {
        "VTENEXT_URL": "<VTENEXT_URL>",
        "VTENEXT_USERNAME": "<VTENEXT_USERNAME>",
        "VTENEXT_ACCESS_KEY": "<VTENEXT_ACCESS_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp-vtenext": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@castaldosolutions/mcp-vtenext"
      ],
      "env": {
        "VTENEXT_URL": "<VTENEXT_URL>",
        "VTENEXT_USERNAME": "<VTENEXT_USERNAME>",
        "VTENEXT_ACCESS_KEY": "<VTENEXT_ACCESS_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-vtenext": {
      "command": "npx",
      "args": [
        "-y",
        "@castaldosolutions/mcp-vtenext"
      ],
      "env": {
        "VTENEXT_URL": "<VTENEXT_URL>",
        "VTENEXT_USERNAME": "<VTENEXT_USERNAME>",
        "VTENEXT_ACCESS_KEY": "<VTENEXT_ACCESS_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp-vtenext": {
      "command": "npx",
      "args": [
        "-y",
        "@castaldosolutions/mcp-vtenext"
      ],
      "env": {
        "VTENEXT_URL": "<VTENEXT_URL>",
        "VTENEXT_USERNAME": "<VTENEXT_USERNAME>",
        "VTENEXT_ACCESS_KEY": "<VTENEXT_ACCESS_KEY>"
      }
    }
  }
}
```

## Tools

- `list_opportunita`: List opportunities with optional filters for status, search text and limit.
- `get_opportunita`: Get full details of an opportunity by ID.
- `search_opportunita`: Search opportunities by name.
- `create_opportunita`: Create a new opportunity (blocked in read-only mode).
- `update_opportunita`: Update status, amount or notes on an existing opportunity (blocked in read-only mode).
- `search_contatti`: Search contacts by name, email or company.
- `add_nota_opportunita`: Add a comment or note to an opportunity (blocked in read-only mode).
- `list_attivita_opportunita`: List activities linked to an opportunity.
- `describe_modulo`: Show available fields for a VTENext module.
- `query_raw`: Run a raw VTQL SELECT query.

## FAQ

### Does it work with MCP clients other than Claude?

The article says the server implements the standard MCP protocol and names Claude Desktop and Claude Code as examples; it is compatible with any MCP client that supports stdio.

### Is it licensed as open source?

Yes, the README lists the licence as MIT.

### How do I stop the assistant from changing data?

Set READ_ONLY to true. The README says the create, update and add-note tools then return an error instead of writing.

### What do I need to run it?

The README lists Node.js 18 or later and a running VTENext instance, either self-hosted or in Docker.

### Is VTENext CRM free?

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

### How do I add VTENext CRM to Claude Code?

Run this command in your terminal: claude mcp add mcp-vtenext --env VTENEXT_URL='<VTENEXT_URL>' --env VTENEXT_USERNAME='<VTENEXT_USERNAME>' --env VTENEXT_ACCESS_KEY='<VTENEXT_ACCESS_KEY>' -- npx -y @castaldosolutions/mcp-vtenext

### What are the best alternatives to VTENext CRM?

The closest alternatives to VTENext CRM are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## Where this comes from

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

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/vtenext-crm
