JivoSite MCP server

jivosite-mcp

An MCP server for the JivoSite live chat: customer conversations, contacts, agents and webhooks through an AI agent

MCP server

Medium risk

We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.

Why this level

  • Can send messages to customers on the agent's behalf
  • The token grants access to customer conversations and contacts
All reasons and checks
Russian stack

theyahia/jivosite-mcp

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/jivosite-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal

claude mcp add --transport stdio --env 'JIVOSITE_TOKEN=<your JIVOSITE_TOKEN>' jivosite -- npx -y @theyahia/jivosite-mcp

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "jivosite": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "jivosite": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"jivosite","type":"stdio","command":"npx","args":["-y","@theyahia/jivosite-mcp"],"env":{"JIVOSITE_TOKEN":"<your JIVOSITE_TOKEN>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "jivosite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add jivosite --env 'JIVOSITE_TOKEN=<your JIVOSITE_TOKEN>' -- npx -y @theyahia/jivosite-mcp

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.jivosite]
command = "npx"
args = ["-y", "@theyahia/jivosite-mcp"]
env = { JIVOSITE_TOKEN = "<your JIVOSITE_TOKEN>" }

If the file already exists, append the block to the end.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "jivosite": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "jivosite": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "jivosite": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "jivosite": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "jivosite": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "environment": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "jivosite": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "jivosite": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/jivosite-mcp"
      ],
      "env": {
        "JIVOSITE_TOKEN": "<your JIVOSITE_TOKEN>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

JIVOSITE_TOKENsecret, required

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 554266a.

Text for your agent

Get JIVOSITE_TOKEN from the JivoSite panel under Management, API, then connect the server with claude mcp add jivosite -e JIVOSITE_TOKEN=your-token -- npx -y @theyahia/jivosite-mcp.

Other ways from the author
claude mcp add jivosite -e JIVOSITE_TOKEN=your-token -- npx -y @theyahia/jivosite-mcp

Command from the README for Claude Code.

This is third-party code. Review the repository files before installing.

What it does

The server talks to the JivoSite API using a token from the control panel and gives an agent nine tools: listing chats filtered by status, listing agents, searching contacts by name, email or phone and creating one, reading a specific chat's messages and sending a reply, plus listing, creating and deleting webhooks. Two Claude Code skills immediately show active chats and agent online or offline statistics without extra parameters.

Who it is for. For support and sales teams using the JivoSite live chat who want to review conversations and reply to customers through an agent.

Good fit when

  • You want a summary of active chats and agent workload without opening the JivoSite panel
  • You need to quickly find a customer's contact and message history
  • You need to set up or remove a webhook for an integration with another system

Not a fit when

  • Your company does not use JivoSite
  • You need to configure the chat widget on the site itself, not work with data through the API

Example request

Show how many JivoSite agents are online now and which chats are currently active

Limitations

The project has a single author and is part of the same author's larger series of Russian API MCP servers. send_message really sends a reply to the customer on the agent's behalf. The README does not describe rate limits or token permissions.

How to disable. Remove the jivosite server from your MCP client config.

MCP

Transport
stdio, http
Authentication
API key
Environment variables
Environment variables
JIVOSITE_TOKEN
required, secret
API token from the JivoSite panel, Management, API section.

Security check

  • Can send messages to customers on the agent's behalf
  • The token grants access to customer conversations and contacts

README in short

The Russian README describes configs for Claude Desktop, Claude Code, VS Code, Cursor, Streamable HTTP and installation via Smithery, and gives a table of nine tools and two skills. A separate section covers JivoSite's referral program with a commission on referred customers. Part of the same author's Russian API MCP series.

FAQ

Can the server reply to a customer in chat on its own?

Yes, the send_message tool sends a message to a specific chat as the agent, and this is a real action.

Can new contacts be created through the server?

Yes, the create_contact tool adds a new contact with the given data.

Official

Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent

MCP serverHigh risk483Repository stars
Official

Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex

PluginHigh riskRussian stackNo VPN needed28Repository stars
Editors’ pick

Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit

MCP serverHigh riskRussian stackNo VPN needed

Bitrix24 portal MCP server

MCP-сервер портала Битрикс24

Official

Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail

MCP serverHigh riskRussian stackNo VPN needed
Foxx AIJivoSite MCP server

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.