VTENext CRM

● Active

it.castaldosolutions/mcp-vtenext

VTENext CRM tools for Claude and MCP clients: opportunities, contacts, notes, VTQL queries.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "mcp-vtenext": {
      "command": "npx",
      "args": [
        "-y",
        "@castaldosolutions/mcp-vtenext@1.1.0"
      ],
      "env": {
        "VTENEXT_URL": "<your VTENEXT_URL>",
        "VTENEXT_USERNAME": "<your VTENEXT_USERNAME>",
        "VTENEXT_ACCESS_KEY": "<your VTENEXT_ACCESS_KEY>",
        "READ_ONLY": "false"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env VTENEXT_URL='<your VTENEXT_URL>' --env VTENEXT_USERNAME='<your VTENEXT_USERNAME>' --env VTENEXT_ACCESS_KEY='<your VTENEXT_ACCESS_KEY>' --env READ_ONLY=false --transport stdio mcp-vtenext -- npx -y @castaldosolutions/mcp-vtenext@1.1.0
OpenAI Codex CLI
codex mcp add mcp-vtenext --env VTENEXT_URL='<your VTENEXT_URL>' --env VTENEXT_USERNAME='<your VTENEXT_USERNAME>' --env VTENEXT_ACCESS_KEY='<your VTENEXT_ACCESS_KEY>' --env READ_ONLY=false -- npx -y @castaldosolutions/mcp-vtenext@1.1.0
VS Code
code --add-mcp '{"name":"mcp-vtenext","type":"stdio","command":"npx","args":["-y","@castaldosolutions/mcp-vtenext@1.1.0"],"env":{"VTENEXT_URL":"<your VTENEXT_URL>","VTENEXT_USERNAME":"<your VTENEXT_USERNAME>","VTENEXT_ACCESS_KEY":"<your VTENEXT_ACCESS_KEY>","READ_ONLY":"false"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • VTENEXT_URLrequiredBase URL of your VTENext instance
  • VTENEXT_USERNAMErequiredVTENext user the server logs in as
  • VTENEXT_ACCESS_KEYrequiredsecretAccess key of that user, in VTENext under Admin > Users > user > Access Key
  • READ_ONLYSet to true to block every write tool

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Business & CRM
Version
1.1.0
Registry
active
Published
11/17/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 19, 2026

Looks healthy: VTENext CRM is maintained, open source.

Maintained
Active
Last commit 4 days ago (Nov 17, 2026), 1 open issues.
Official registry
Active
Published as it.castaldosolutions/mcp-vtenext in the official MCP registry, version 1.1.0.
Source
Open source, MIT
Public repository under the MIT licence, 4 stars, 0 forks.
Runs
On your machine
A local npm package started by your client; it can reach whatever your user account can.
Credentials
3 required
Declared environment variables: VTENEXT_URL, VTENEXT_USERNAME, VTENEXT_ACCESS_KEY. They stay on your machine; the config on this page shows where each goes.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 18, 2026
Stars
4
Forks
0
Last push
Nov 17, 2026
License
MIT

JavaScript

From the README

mcp-vtenext MCP server for VTENext CRM: exposes the WebService API as tools for Claude and other MCP-compatible clients. Requirements • Node.js 18+ • A running VTENext instance (self-hosted or Docker, see ../docker) Setup Edit .env: The access key is in VTENext under Admin → Users → [user] → Access Key. Read-only mode Set READONLY=true to prevent any write operation on VTENext. When enabled, the tools createopportunita, updateopportunita and addnota_opportunita return an error instead of writing data. This is useful when the server is used by AI bots or automated agents that should only read CRM data. To run a read-only instance alongside a full-access one, pass the variable via the MCP config: Claude Code integration Add to .mcp.json in your project root: Tools Opportunità (Potentials) Contatti (Contacts) Attività e note Utilità Authentication VTENext uses the vtiger WebService protocol: 1. GET /webservice.php?operation=getchallenge → token 2. MD5(token + accessKey) → hashed key 3. POST /webservice.php with operation=login (form-encoded) → sessionName Sessions are cached for 4 minutes (token lifetime is 5 minutes). Tests License MIT Maintained by Castaldo Solutions, enterprise-grade technology built for SMEs. Why we built an MCP server for a CRM instead of an integration: Connecting VTENext to Claude with MCP.

Read the full README on GitHub →

The most-starred Business & CRM servers in the index, with their live-check result.

ServerStarsLast pushLive check
Contact Affordance7,477Nov 2026Working
Business Contact Finder7,470Nov 2026Working
JobSpy4,739Nov 2026Local / not checked
Relaticle1,915Nov 2026Needs sign-in
ChatbotX1,142Nov 2026Needs sign-in

VTENext CRM: questions people ask

Is VTENext CRM a remote or a local MCP server?
According to its entry in the official MCP registry, VTENext CRM ships as a local package (npm) that your client starts on your machine.
Does VTENext CRM need an API key?
Its registry entry declares 3 required environment variables: VTENEXT_URL, VTENEXT_USERNAME, VTENEXT_ACCESS_KEY. The config on this page shows where each goes.
Is VTENext CRM safe to use?
Looks healthy: VTENext CRM is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: 3 required. Serverdex check of Nov 19, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is VTENext CRM still maintained?
Active: the repository's last commit 4 days ago. Last push Nov 17, 2026, 4 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
How do I add VTENext CRM to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Business & CRM →

Add the badge to your site

Show visitors that VTENext CRM is listed here — it’s also the link we check for a free listing.

VTENext CRM — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/it-castaldosolutions-mcp-vtenext?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="VTENext CRM — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![VTENext CRM — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/it-castaldosolutions-mcp-vtenext?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/it-castaldosolutions-mcp-vtenext) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/it-castaldosolutions-mcp-vtenext) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/it-castaldosolutions-mcp-vtenext)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/it-castaldosolutions-mcp-vtenext"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/it-castaldosolutions-mcp-vtenext"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/it-castaldosolutions-mcp-vtenext"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).