iikoServer MCP Server
iikoServer REST API MCP server: menu items, staff, invoices, cash shifts, OLAP reports and revenue by venue
- 2 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Can change recipe cards and record cash encashment in the live restaurant system
- Keeps the iiko login and password in plain text, with SSL verification off by default
- Raw calls reach any iikoServer endpoint beyond the tool list
Install
- Works in
- Services
Manual install
pip install -r requirements.txtRun inside a clone of https://github.com/simba87/iiko-server-mcp. Start with IIKO_URL=... IIKO_LOGIN=... IIKO_PASS=... python3 server.py.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Can change recipe cards and record cash encashment in the live restaurant system
- Keeps the iiko login and password in plain text, with SSL verification off by default
- Raw calls reach any iikoServer endpoint beyond the tool list
This is third-party code. Review the repository files before installing.
What it does
The server gives the agent over 40 tools for the iiko restaurant system. It reads menu items, product groups, staff, warehouses, suppliers, incoming and outgoing invoices, write-offs, recipe cards, cash shifts and payments. Reports include OLAP queries, saved presets and ready summaries: revenue by venue, top dishes, staff meals, day-over-day revenue and individual checks. There are write tools for recipe cards and cash encashment, plus a raw call to any iikoServer endpoint. The server logs in by itself and logs out on shutdown to free the license slot.
Who it is for. Restaurant owners and managers, analysts and integrators working with iiko.
Good fit when
- You need daily revenue per venue compared with yesterday
- You need top dishes by revenue for a period
- You need a supplier's invoices or write-offs for a week
Not a fit when
- You need the iikoCloud API rather than iikoServer
- The agent must not get credentials that can change recipe cards and cash
Example request
Compare yesterday's revenue across all venues with the day before and show the top 10 dishes for the weekMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
IIKO_URLrequired- iikoServer base URL
IIKO_LOGINrequired- iiko user login
IIKO_PASSrequired, secret- iiko user password
IIKO_VENUE_MAP- Venue names for cash register numbers
IIKO_VERIFY_SSL- SSL verification, default false
Limitations
Requires the iikoServer URL, a user login and password, with the password kept in plain environment variables. SSL certificate verification is off by default. Some endpoints, such as payment types, are missing in certain iikoServer versions, and staff meals are detected by payment type name. The whole server is a single file published in one commit, with no package.
How to disable. Remove the iiko-server block from your MCP client config. If you created a dedicated iiko user, disable it.
FAQ
Does the server take an iiko license slot?
It opens a session while running and logs out on clean shutdown to free the slot.
How do I name cash registers by venue?
Set IIKO_VENUE_MAP in the form Cafe A=4,Cafe B=5.
How is the iikoServer MCP Server different from other iiko MCP servers?
The server gives the agent over 40 tools of the iikoServer REST API: nomenclature, product groups, employees, warehouses, suppliers, incoming and outgoing invoices, write-offs, tech cards, cash shifts, OLAP reports and revenue by venue.
Does the server take an iiko license and how do I label cash registers with venue names?
Yes, while connected the server occupies an iiko license slot, and on shutdown it logs out and releases it. Venue names for cash registers are set in the server configuration, see the README. Install with pip install -r requirements.txt. It works in Claude Desktop and Cursor. Risk is high.
Discussion
No questions or reviews yet.
Related
All iiko toolsiikoServer MCP: 39 iiko REST API tools
iikoServer MCP Server
An MCP server for the iikoServer REST API: products, employees, invoices, cash shifts, encashment and OLAP reports, including raw calls to any endpoint
An MCP server for the iikoCloud API: pick the needed subset from 236 methods by domain, defaults to read-only, confirms before every write
A lightweight MCP server for manually debugging the iikoTransport API (api-ru.iiko.services) with v2 authorization and a universal arbitrary-request tool
Multi-tenant Pyrus MCP server
Pyrus AI Ecosystem — MCP Infrastructure
An enterprise Pyrus v4 API MCP server with multi-tenancy, SQLite persistence and metrics, inside a larger monorepo
MCP server for the MoySklad JSON API 1.2: stock, orders, profit reports and document creation behind two safety gates
Intuit's official local MCP server: an agent finds and creates invoices, payments and customers in QuickBooks Online
README in short
The English README describes server features and running it locally with pip or in Docker in interactive mode. It lists environment variables and config examples for Hermes Agent, Claude Desktop and Cursor. Tools are grouped, with dangerous write operations flagged. It includes a date format table, known limitations and how to add a tool. MIT license.