Mango Office MCP server

mango-office-mcp

An MCP server for Mango Office cloud telephony: call statistics, call recordings, SMS and click-to-call

MCP server

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

Why this level

  • Can start real calls and send SMS on the company's behalf
  • The API key and salt grant access to call recordings and statistics
All reasons and checks
Russian stack

theyahia/mango-office-mcp

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/mango-office-mcp

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

Other ways to install

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio --env 'MANGO_API_KEY=<your MANGO_API_KEY>' --env 'MANGO_API_SALT=<your MANGO_API_SALT>' mango-office -- npx -y @theyahia/mango-office-mcp

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

{
  "mcpServers": {
    "mango-office": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "env": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

Keys and settings

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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 ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "mango-office": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "env": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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

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

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

{
  "servers": {
    "mango-office": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "env": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

Keys and settings

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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 mango-office --env 'MANGO_API_KEY=<your MANGO_API_KEY>' --env 'MANGO_API_SALT=<your MANGO_API_SALT>' -- npx -y @theyahia/mango-office-mcp

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

[mcp_servers.mango-office]
command = "npx"
args = ["-y", "@theyahia/mango-office-mcp"]
env = { MANGO_API_KEY = "<your MANGO_API_KEY>", MANGO_API_SALT = "<your MANGO_API_SALT>" }

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

Keys and settings

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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": {
    "mango-office": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "env": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

Keys and settings

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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": {
    "mango-office": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "env": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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": {
    "mango-office": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "env": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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": {
    "mango-office": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "env": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

Keys and settings

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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": {
    "mango-office": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "environment": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

Keys and settings

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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": {
    "mango-office": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "env": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

Keys and settings

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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": {
    "mango-office": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/mango-office-mcp"
      ],
      "env": {
        "MANGO_API_KEY": "<your MANGO_API_KEY>",
        "MANGO_API_SALT": "<your MANGO_API_SALT>"
      }
    }
  }
}

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

Keys and settings

MANGO_API_KEYsecret, required
MANGO_API_SALTsecret, 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 84700e4.

Text for your agent

Get MANGO_API_KEY and MANGO_API_SALT from your mango-office.ru account, then connect the server with claude mcp add mango-office -e MANGO_API_KEY=your-key -e MANGO_API_SALT=your-salt -- npx -y @theyahia/mango-office-mcp.

Other ways from the author
claude mcp add mango-office -e MANGO_API_KEY=your-key -e MANGO_API_SALT=your-salt -- npx -y @theyahia/mango-office-mcp

Command from the README for Claude Code.

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

What it does

The server signs requests to the Mango Office API with HMAC-SHA256 using a key and salt from the account dashboard, and gives an agent six tools: call history for a period, an employee list, click-to-call outbound dialing, summary statistics, a link to a call recording, and sending SMS. Two ready Claude Code skills return a call report and today's statistics summary without extra parameters.

Who it is for. For sales and support team leads who use Mango Office cloud PBX and want call statistics and recordings through an agent.

Good fit when

  • You want a call summary for an hour, a day or another period without opening the dashboard
  • You need to quickly find and download the recording of a specific call
  • You want to start a call or send an SMS to a client right from a chat with an agent

Not a fit when

  • Your company does not use Mango Office
  • You need PBX or call-routing configuration rather than working with calls and SMS through the API

Example request

Show today's Mango Office call statistics and download the recording of the last customer call

Limitations

The project has a single author and is part of the WWmcp series. The make_call tool starts a real call, and send_sms actually sends a message and spends account balance. The README does not describe request limits or API key permissions.

How to disable. Remove the mango-office server from your MCP client config.

MCP

Transport
stdio, http
Authentication
API key
Environment variables
Environment variables
MANGO_API_KEY
required, secret
Mango Office API key from the account dashboard.
MANGO_API_SALT
required, secret
Mango Office API salt used to sign requests.

Security check

  • Can start real calls and send SMS on the company's behalf
  • The API key and salt grant access to call recordings and statistics

README in short

The Russian README gives configs for Claude Desktop, Claude Code, VS Code, Cursor and Streamable HTTP, explains the HMAC-SHA256 request signing scheme, and lists six tools with their matching API endpoints. It ends with a link to Mango Office's referral program and the same author's WWmcp series.

FAQ

Can the server call a customer on its own?

Yes, the make_call tool starts an outbound call between two numbers via commands/callback, which is a real action, not a read.

How are API requests signed?

HMAC-SHA256 using sign = HMAC(apiKey + json + apiSalt), documented in its own README section.

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 AIMango Office 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.