iikoServer MCP Server
iikoServer REST API MCP server: menu items, staff, invoices, cash shifts, OLAP reports and revenue by venue
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.
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 weekLimitations
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.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| IIKO_URL required | iikoServer base URL |
| IIKO_LOGIN required | iiko user login |
| IIKO_PASS required, secret | iiko user password |
| IIKO_VENUE_MAP | Venue names for cash register numbers |
| IIKO_VERIFY_SSL | SSL verification, default false |
Security check
- 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
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.
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.
Related
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
The official CCXT MCP server and skills: market data, balances and opt-in trading across crypto exchanges and prediction markets
Skill plugins for analyzing stocks, earnings, options and startups, plus readers for social feeds and market data
Skills and an MCP server for options traders: quotes, technical analysis, Greeks, spreads, scanners and Interactive Brokers portfolio