Content
# @theyahia/mango-office-mcp
MCP Server for Mango Office API — calls, users, recordings, SMS, statistics. **8 tools.**
[](https://www.npmjs.com/package/@theyahia/mango-office-mcp)
[](https://opensource.org/licenses/MIT)
Part of the series [Russian API MCP](https://github.com/theYahia/russian-mcp) (50 servers) by [@theYahia](https://github.com/theYahia).
## Installation
### Claude Desktop
```json
{
"mcpServers": {
"mango-office": {
"command": "npx",
"args": ["-y", "@theyahia/mango-office-mcp"],
"env": { "MANGO_API_KEY": "your-key", "MANGO_API_SALT": "your-salt" }
}
}
}
```
### Claude Code
```bash
claude mcp add mango-office -e MANGO_API_KEY=your-key -e MANGO_API_SALT=your-salt -- npx -y @theyahia/mango-office-mcp
```
### VS Code / Cursor
```json
{ "servers": { "mango-office": { "command": "npx", "args": ["-y", "@theyahia/mango-office-mcp"], "env": { "MANGO_API_KEY": "your-key", "MANGO_API_SALT": "your-salt" } } } }
```
### Streamable HTTP
```bash
npx @theyahia/mango-office-mcp --http
# POST /mcp, GET /health — port 3000 (PORT=8080 for another)
```
> `MANGO_API_KEY` and `MANGO_API_SALT` are required. Get them in your personal account at [Mango Office](https://www.mango-office.ru).
## Authentication
All requests are signed with HMAC-SHA256: `sign = HMAC(apiKey + json + apiSalt)`.
Base URL: `https://app.mango-office.ru/vpbx/`.
## Tools (6)
| Tool | Description | API endpoint |
|------|-------------|--------------|
| `get_calls` | Call history for a period | `stats/request` |
| `get_users` | List of users | `config/users/request` |
| `make_call` | Initiate an outgoing call | `commands/callback` |
| `get_stats` | Summary call statistics | `stats/request` |
| `get_recording` | Link to conversation recording | `queries/recording/post` |
| `send_sms` | Send SMS | `commands/sms` |
## Skills (2)
| Tool | Description |
|------|-------------|
| `skill_call_history` | Call history for today — ready report |
| `skill_stats` | Call statistics for today — summary |
## Examples
```
Show calls for the last hour
List of Mango Office users
Call from 101 to +79001234567
Call statistics for today
Download conversation recording rec_123
Send SMS from 101 to +79001234567 "Call back"
```
## Mango Office
[Mango Office](https://www.mango-office.ru/?utm_source=github&utm_medium=mcp) — cloud telephony for business.
Referral program: **up to 25% lifetime** from payments of referred customers.
## License
MIT
