
VTENext CRM
VTENext CRM tools for Claude and MCP clients: opportunities, contacts, notes, VTQL queries.
- GitHub stars
- 4
- tools
- 10
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Nov 17, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
list_opportunitaList opportunities with optional filters (status, search, limit)
List opportunities with optional filters (status, search, limit)
No parameter schema in public metadata yet.
get_opportunitaGet full details of an opportunity by ID
Get full details of an opportunity by ID
No parameter schema in public metadata yet.
search_opportunitaSearch opportunities by name
Search opportunities by name
No parameter schema in public metadata yet.
create_opportunitaCreate a new opportunity (write, blocked in read-only mode)
Create a new opportunity (write, blocked in read-only mode)
No parameter schema in public metadata yet.
update_opportunitaUpdate status, amount or notes on an existing opportunity (write, blocked in read-only mode)
Update status, amount or notes on an existing opportunity (write, blocked in read-only mode)
No parameter schema in public metadata yet.
search_contattiSearch contacts by name, email or company
Search contacts by name, email or company
No parameter schema in public metadata yet.
add_nota_opportunitaAdd a comment/note to an opportunity (write, blocked in read-only mode)
Add a comment/note to an opportunity (write, blocked in read-only mode)
No parameter schema in public metadata yet.
list_attivita_opportunitaList activities linked to an opportunity
List activities linked to an opportunity
No parameter schema in public metadata yet.
describe_moduloShow available fields for any VTENext module
Show available fields for any VTENext module
No parameter schema in public metadata yet.
query_rawRun a raw VTQL SELECT query
Run a raw VTQL SELECT query
No parameter schema in public metadata yet.
Sponsors
Configuration
VTENEXT_URL*Base URL of your VTENext instance
VTENEXT_USERNAME*VTENext user the server logs in as
VTENEXT_ACCESS_KEY*secretAccess key of that user, in VTENext under Admin > Users > user > Access Key
READ_ONLYdefault: falseSet to true to block every write tool
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
cd mcp/vtenext/server
npm install
cp .env.example .env
Edit .env:
VTENEXT_URL=http://your-vtenext-instance
VTENEXT_USERNAME=admin
VTENEXT_ACCESS_KEY=your_access_key
READ_ONLY=false
The access key is in VTENext under Admin → Users → [user] → Access Key.
Read-only mode
Set READ_ONLY=true to prevent any write operation on VTENext. When enabled, the tools create_opportunita, update_opportunita and add_nota_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:
Details
- Repository
- github.com/castaldo-solutions/mcp-vtenext
- Website
- www.castaldosolutions.it/articles/en/blog/mcp-server-vtenext-crm-claude
- Categories
- Sales & Marketing, Finance & Commerce
- Package
@castaldosolutions/mcp-vtenext- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active