Adam OS MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Adam OS MCP Server What's my labor percentage this week for both restaurants?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Adam OS — MCP Server
Executive Operating System for Adam Perna · Stoic Holdings · CH Projects · San Diego
What This Does
Adam OS runs as an MCP server inside Claude Desktop. You talk to it naturally — Claude uses the tools automatically.
Related MCP server: Gerent365 MCP Server
Tools Available
Tool | What it does |
| Full status of both restaurants |
| Labor hours, cost, % by location |
| Hours per employee, overtime flags |
| Sales, covers, avg check by location |
| Per-server breakdown for tip pools |
| Parse & store any Toast CSV export |
| Show all previously imported files |
| Tip pool math from server sales data |
| Open tasks, filtered by priority |
| Create a new task |
| Mark task done |
| Save shift notes, incidents, observations |
| Retrieve saved notes |
| Full health check of Adam OS |
Installation
bash install.shImporting Toast Data
In Toast: Reports → Labor → Time Entries → Export CSV
In Toast: Reports → Sales Summary → Export CSV
In Toast: Reports → Server Sales → Export CSV
Drop the files in
~/Desktop/Toast ImportsTell Claude: "Import my Toast CSV"
Data Storage
All data stored locally at ~/.adam-os/adam.db — SQLite, no cloud, no servers.
Example Conversations
"What's my labor percentage this week for both restaurants?"
"Who's close to overtime at Reading Club?"
"I dropped a Toast CSV on my desktop, can you import it?"
"Calculate the tip pool for last week at Seneca"
"Add a high priority task: approve Saturday schedule"
"Run a system diagnostic"
Available Tools
14 toolsadd_taskC
Add a new task or action item.
Inputs: title (required), priority, due_date, category, +1 more.
calculate_tip_poolC
Calculate tip pool distribution based on imported server sales data.
Inputs: business.
complete_taskC
Mark a task as complete.
Inputs: task_id (required).
get_business_overviewA
Get a complete overview of both restaurants — Reading Club and Seneca Trattoria — including current KPIs, alerts, and data status.
Inputs: no named parameters.
get_employee_hoursB
Get hours and pay for employees. Flags overtime. Use to check if anyone is approaching overtime threshold.
Inputs: employee_name, days.
get_labor_summaryA
Get labor hours, cost, and labor percentage. Works with real Toast data if imported, otherwise shows current known metrics.
Inputs: business, days.
get_notesC
Get saved shift notes, incidents, or observations.
Inputs: category, business, limit.
get_sales_summaryC
Get sales, covers, and average check data from imported Toast reports.
Inputs: business, days.
get_server_salesC
Get per-server sales, covers, and tips. Used for tip pool calculations.
Inputs: business, days.
get_tasksB
Get tasks and to-dos. Filter by priority or status.
Inputs: filter.
import_toast_csvA
Import a Toast POS CSV export. Auto-scans ~/Desktop/Toast Imports folder if no path given. Accepts labor, sales summary, or server sales reports.
Inputs: file_path, business_name.
list_importsA
List all previously imported Toast CSV files.
Inputs: no named parameters.
save_noteC
Save a shift note, incident report, or any observation.
Inputs: title (required), content (required), category, business.
system_diagnosticB
Run a complete health check of Adam OS. Check all data, tools, and status.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Each tool targets a distinct aspect of restaurant management: tasks, sales, labor, notes, imports, and system diagnostics. There is no overlap; even related tools like get_sales_summary and get_server_sales are clearly differentiated by scope.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., add_task, get_sales_summary, import_toast_csv). No mixing of conventions or vague verbs.
With 14 tools covering tasks, sales, labor, imports, and health checks, the count is well-scoped for a restaurant management assistant. Each tool feels necessary without redundancy.
The tool set covers core CRUD operations for tasks and notes, plus detailed reporting and imports. Minor gaps exist—no update or delete for tasks/notes—but the core workflows are complete, and the system_diagnostic tool provides additional oversight.
Related MCP Connectors
Run your restaurant from an AI client: orders, menu, reports, refunds, payouts and staff.
Free for restaurant owners. Drop last night's close, get the one thing to fix before next shift.
Run your restaurant group's events, leads, invoices and marketing drafts from your AI assistant.
Read-only restaurant finance, cost, stock and staff-hours assistant for restoorun owners.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to manage restaurant operations by integrating with Toast POS, including orders, menus, employees, payments, inventory, and reporting through 50+ tools and 18 React apps.816MIT
- FlicenseBqualityDmaintenanceEnables AI assistants to manage Gerent365 restaurant and business operations via natural language, including employees, schedules, payroll, tips, time tracking, customers, products, reservations, and reports.531-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to query live Toast POS data and generate sales, labor, and cash reports while answering restaurant operations questions, all in a read-only manner.33 npmMIT
- AlicenseCqualityBmaintenanceEnables Claude or any MCP client to query a Toast POS using plain English, with 55 read-only tools covering orders, sales, labor, employees, menus, inventory, customers, and cash.552MIT