Jivosite MCP logo

Jivosite MCP

Connects AI assistants to JivoSite chats, agents, contacts, messages, and webhooks through MCP tools.

Install Jivosite MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "jivosite-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

The install command didn't complete successfully in our automated test.

npx -y @theyahia/jivosite-mcp

dy while trying to fetch https://registry.npmjs.org/content-type: aborted npm ERR! network This is a problem related to network connectivity. npm ERR! network In most cases you are behind a proxy or have bad network settings. npm ERR! network npm ERR! network If you are behind a proxy, please make sure that the npm ERR! network 'proxy' config is set properly. See: 'npm help config' npm ERR! A complete log of this run can be found in: /home/user/.npm/_logs/2026-10-18T11_31_28_804Z-debug-0.log

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 5d ago.

Overview

The jivosite-mcp MCP server connects AI assistants to the JivoSite API for working with chats, agents, contacts, messages, and webhooks. It runs through npx in stdio mode by default or exposes a streamable HTTP MCP endpoint when started with the HTTP option. Reach for it when an assistant needs to inspect conversations, send chat messages, manage contacts or webhooks, or review operator status through JivoSite.

Use cases

  • Inspect recent JivoSite chats
  • Find contacts by email or phone
  • Send replies to customer conversations
  • Review active chats and operator availability

Key features

  • List and filter chats
  • Search and create contacts
  • Read and send chat messages
  • Manage JivoSite webhooks
  • Check active chats and agent status
  • Run over stdio or streamable HTTP

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

4/4 checks healthy over the last 34d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @theyahia/jivosite-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads108Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Install checkInconclusiveInstall command did not finish in our automated test.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Jivosite MCP works

What jivosite-mcp MCP server does

The jivosite-mcp MCP server exposes JivoSite customer-support data and actions through the Model Context Protocol. It covers chat discovery, operator lists, contact lookup and creation, message retrieval, outbound chat messages, and webhook management.

These provide task-oriented ways to ask about live conversations and online or offline agents.

The repository advertises 10 tools, while the tools table names these 9 operations: get_chats, get_agents, get_contacts, create_contact, get_messages, send_message, get_webhooks, create_webhook, and delete_webhook.

How it works

The package communicates with JivoSite through the API using a token supplied in the JIVOSITE_TOKEN environment variable. An MCP-compatible client starts the package with npx, then invokes its tools as needed.

In the default stdio mode, the client launches the process directly. The optional HTTP mode starts a server on a selected port, with the MCP endpoint at /mcp and a health check at /health. This gives developers a choice between local process-based configuration and an HTTP-accessible MCP endpoint.

Setup and configuration

Create or obtain a JivoSite API token from the JivoSite control panel under Management and API. Store it as JIVOSITE_TOKEN; the README marks this variable as required.

For Claude Desktop, configure an MCP server that runs npx -y @theyahia/jivosite-mcp and passes the token in its environment. Claude Code can be configured with claude mcp add, while VS Code and Cursor use an equivalent server configuration with the same command and environment variable. Smithery installation is also documented through its CLI.

To use HTTP mode, run the package with --http --port=3000. The documented local URLs are http://localhost:3000/mcp for MCP requests and http://localhost:3000/health for health checks.

Tools and capabilities

  • List chats, optionally filtering by status with get_chats.
  • List JivoSite agents with get_agents.
  • Search contacts by name, email address, or phone number.
  • Create contacts through create_contact.
  • Read messages for a specified chat ID.
  • Send a message to a chat.
  • List, create, and delete webhooks.
  • Ask for active chats through skill_active_chats.
  • Check operator online and offline statistics through skill_agent_stats.

Limitations and notes

The documented integration is specifically for JivoSite.

The repository is licensed under MIT. The README includes referral-program information for JivoSite, but that program is separate from the server’s technical functionality.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Jivosite MCP

jivosite-mcp is an MCP server that connects AI assistants to the JivoSite API. Its main tools list chats, agents, contacts, messages, and webhooks; create contacts and webhooks; delete webhooks; and send messages to chats. It also provides skills for active chats and operator online or offline statistics.

Install it by running it with npx and setting the required JIVOSITE_TOKEN environment variable. The README provides configurations for Claude Desktop, Claude Code, VS Code, and Cursor, plus a Smithery CLI installation command.

Yes, jivosite-mcp has a documented Cursor configuration. Add a server that runs npx -y @theyahia/jivosite-mcp and provide your JivoSite token as JIVOSITE_TOKEN.

Run npx -y @theyahia/jivosite-mcp --http --port=3000. The MCP endpoint is then available at http://localhost:3000/mcp, and the documented health-check URL is http://localhost:3000/health.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewJivosite MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/jivosite-mcp?style=directory)](https://allmcps.com/mcp/jivosite-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/jivosite-mcp"><img src="https://allmcps.com/api/badge/jivosite-mcp?style=directory" alt="Jivosite MCP on AllMCPs" /></a>