Kamra PMS
The world's first open-source, agentic AI-ready PMS.
The hotel PMS your staff and your AI can both run.
Front desk, housekeeping, billing, F&B, banquets and a booking engine for hotels, resorts and villas,
with a governed MCP layer so Claude or ChatGPT works as a permission-checked member of staff.
Try the demo · Read the docs · Install
Why "first": Kamra 1.0 shipped on 5 July 2026 as open source, free, and MCP-driven. We know of no open-source PMS that shipped all three earlier. If Kamra is useful to you, star the repo so other hoteliers and developers can find it.
Kamra is a full property management system for hotels, resorts and short-term rentals. It runs on Frappe (the framework behind ERPNext), it is Apache-2.0, and every feature is in the open-source app: no editions, no per-room fees. Current release: v2.7.6 (changelog).
On the demo, tap any role to sign in. The guest booking page is at /book and the housekeeping phone app at /kamra/hk.
!Kamra's Today screen: arrivals, departures, KPIs, the room board and in-house guests
What Kamra does
Front desk
- Today screen with arrivals, departures, in-house guests, balances due and a live room board.
- One-screen walk-ins, guided check-in with an ID card per guest, group check-in, and online self check-in by link.
- Tape chart and calendar: book from an empty cell, move rooms, extend or shorten a stay.
- Groups with a rooming list, group rate, deposit and quotation; central reservations across several properties.
- Room Board for supervisors and a phone app (
/hk) for floor staff: claim a room, start, finish with a photo. - Tasks with deadlines and escalation, guest requests with an SLA report.
- Guest laundry from collection to folio, minibar posting, lost and found, shift handover.
- Folios with a tax rate per line, split and routed billing (the company pays the room, the guest pays the bar), payment links and security deposits.
- Cashier tills, shift reports, petty cash and a currency desk; bills paid and shown in another currency.
- Night audit on one page: only what needs you, one Close button, and an audit pack with every table exportable to CSV; it also runs by itself at 03:00.
- Accounts receivable as a work queue: overdue and over-limit filters, aging, statements and month-end bills to many companies at once.
- Books check that says whether folios and ledgers agree, plus accounts payable, P&L and balance sheet.
- Restaurant POS with a table map, room charges to the folio, kitchen display and network kitchen printers.
- Kitchen stock and recipes that move when an order is sent.
- Banquets from enquiry to quotation, event order (BEO), receipts and close-out, with a venue diary.
- Room types, rate plans, seasons, meal plans, vouchers, negotiated company rates and rate guardrails.
- Manager flash, property and portfolio dashboards (occupancy, ADR, RevPAR), budget against actual.
- Custom report builder with save and email, and report packs per department.
- Your own booking page at
/bookwith live rates, add-ons, instant booking or request to book, and a booking language of its own. - Short-term rentals: a catalogue of villas sold as rooms or the whole place, cleaning fees and refundable deposits.
- Channel manager adapters for Channex.io, STAAH and AioSell; CSV import of bookings when you switch.
- Kamra Agent, the in-app assistant, with action cards to check in, collect or open a folio.
- 170 MCP tools for Claude, ChatGPT or any MCP client. See Run your hotel with AI.
Run your hotel with AI
!Kamra Agent: a reply with a stay card and Check out, Collect, Open folio and Waive deposit actions
- Kamra Agent is built in and on by default. Bring your own key from OpenAI, Gemini, Groq, OpenRouter, Ollama, Azure or any OpenAI-compatible provider. No markup: requests go from your server to your provider.
- MCP for Claude and ChatGPT. Open Kamra Agent → Connect your AI and click Connect Claude, or add your site's
/mcpURL as a connector in ChatGPT. Claude Code works too:
claude mcp add --transport http kamra https://pms.yourhotel.com/mcp
- One write path. The desk, the REST API, Kamra Agent and MCP clients all call the same governed functions. Each call is checked against the person's roles and property, and every change lands in the Activity Log with who, what and why.
- Prices always come from Kamra. Quotes, tax, deposits and availability are computed by Kamra's pricing code. An AI can ask for a quote or post a charge; it never invents a number, and rate guardrails refuse anything outside the floor and ceiling.
- You decide who uses it. A hotel admin gives each person MCP Read or MCP Manage, can make a property read-only for AI, or block single tools.
Kamra is built and maintained by HeyKoala (Koala AI Solutions Pvt Ltd). HeyKoala also offers hosted AI services for hotels, such as guest calls and WhatsApp; they are separate and optional, and Kamra works fully without them.
Country packs
The property's country picks its pack. The pack decides tax, invoice wording, ID types, payment modes, the privacy notice and any country-only integrations, so one country's integrations never show up in another.
| Country | Highlights | |---|---| | India | GST by tariff slab, CGST + SGST or IGST, GSTR-1 export, Razorpay and Cashfree payment links, Form C | | Saudi Arabia | VAT 15%, municipality fee, ZATCA Phase 1 e-invoices with QR, Shomoos register | | United Arab Emirates | VAT 5%, municipality fee, TRN on the tax invoice | | Malaysia | SST on rooms and F&B, tourism tax note | | Thailand | VAT 7%, service charge as its own line | | Indonesia | Regional hotel tax (PB1 / PBJT) | | Philippines | VAT 12%, TIN, peso. Senior citizen and PWD discount is calculated in the pack and posted by hand | | Brazil | ISS, BRL, CNPJ / CPF, NFS-e reference | | Nicaragua | IVA 15%, NIO | | Anywhere else | One flat rate from property settings |
Rates are defaults you can change per property or room type. A new country is one Python module: Write a country pack.
Install
| Method | Best for | Guide | |---|---|---| | Frappe Cloud Marketplace | Managed hosting, no server to run (needs a private bench) | Install via Frappe Cloud | | Docker on a VPS | Hostinger, DigitalOcean, Linode, AWS or your own box | Quickstart | | Bench | Teams already running Frappe or ERPNext | Bench install |
Docker (2 vCPU / 4 GB minimum, three prompts: domain, admin email, admin password):
curl -fsSL https://raw.githubusercontent.com/Kamra-PMS/kamra-pms/main/deploy/install.sh | bash
Cheapest path in India and South-East Asia: a Hostinger KVM 2 through the Kamra referral link (20% off, or coupon KAMRAPMS; it helps keep Kamra going). Hostinger guide.
Bench:
bench get-app payments
bench get-app kamra https://github.com/Kamra-PMS/kamra-pms --branch main
bench --site your-site install-app kamra
Then open /kamra, sign in as Administrator with the password you set (there is no default) and finish /kamra/setup. Production installs track main; develop is the nightly channel. Going live: go-live checklist.
Rather not run a server or set it up yourself? Frappe Cloud hosts, backs up and updates it, and our implementation service covers migration, setup and training. Implementers can list themselves on kamrapms.com/partners.
Docs and help
- Manual: kamrapms.com/docs (guides by role, every module, self-hosting, FAQ), also in Spanish and Arabic
- Developers: REST API reference, Postman collection, How Kamra works
- Why Kamra, and how we fund it: kamrapms.com/why-kamra and kamrapms.com/how-kamra-makes-money
- Bugs and ideas: GitHub issues
- Email: [email protected]
Security
Please report vulnerabilities privately, not in a public issue. See SECURITY.md.
Contributing
Issues and PRs are welcome. Branch from develop, use Conventional Commits, and put anything country-specific in that country's pack, not the core. The full guide, including the eval checks a backend fix needs, is in CONTRIBUTING.md.
Quickstart (development)
bench init --frappe-branch v16.25.0 frappe-bench && cd frappe-bench
bench get-app payments
bench get-app kamra https://github.com/Kamra-PMS/kamra-pms
bench new-site kamra.localhost --admin-password admin
bench --site kamra.localhost install-app kamra
bench serve --port 8000
cd apps/kamra/frontend && npm install && npm run dev # hot-reload UI on :5173
More in docs-dev.md.
License and trademark
The code is Apache-2.0: free to use, change, host and sell, including in proprietary products, with attribution and patent protections as the license requires. Releases published before this change remain AGPL-3.0. The Kamra name and mark are covered by TRADEMARK.md: run and resell Kamra freely, show your own hotel or partner logo next to ours, and give a changed fork its own name.
Contributors
Every merged PR and every issue that shapes a feature is credited in the release notes and here. The full list also lives on the docs site: Contributors.
Code
- @Kruthikagowda12: the AioSell channel-manager adapter and its fixes (#40, #46, #52), housekeeping proof media and room swap / upgrade (#74), phone validation (#69), season scoping (#80), property / booking flow work (#22), and per-head small-group rates with weekend / weekday guardrails (#162), and group rooming-list booking with group rate, deposit and quotation (#422)
- @Mohammed-Muneef: laundry, kitchen display v2, inventory & recipes, menu import, ID-document hardening
- @faresalslahi-collab: booking guest and room summary (#83)
- @ShaikhAmerPasha: saved bookings keep their voucher after it expires or hits its limit (#142, #143), folio charges refuse zero or minus amounts and unknown tax rates (#146, #147), and the bill screen's Void button, which now asks for a reason (#160, #161)
- @ernestoruiz89: Spanish localization and menu navigation fixes (fork #320, landed via #324, included in 2.6.21), international guest phone prefixes (#345, #360), and the chat assistant using the property's currency (#368, 2.6.22), and the MCP OAuth discovery fix (#387, 2.7.0)
- @SandroG1977: Brazil country pack: ISS, BRL, CNPJ/CPF, NFS-e (#378); Portuguese (pt-BR) staff UI (#377, landed via #383); the Portuguese review and wording glossary (#410); the assistant quoting with exact occupancy and tax-inclusive totals (#432); room pricing fields and children on quote cards (#444)
- @pmwanje2: the hotel's own name and logo next to Kamra's (#431, landed via #436)
- @caseylee-TC: Write a country pack tutorial (#362, fixes #258)
- @lhertig: folio payments in the property currency (#341),
max_total_occupantson mixed adult/child bookings (#342), pre-arrival advance refunds releasing Deposit and reducingadvance_paid(#343), and concurrent bookingtabSeriesdeadlock retries (#344) - @faresalslahi-collab (Sarawat Park Hotel & Resort): the one-screen walk-in (#97), which led to the Saudi Arabia pack and ZATCA, Arab-world dial codes (#98), and Kamra's kitchen ledger clashing with ERPNext stock on a shared site (#131)
- @atomic-glitch: the housekeeping Room Board and role checks (#99), room change from the reservation and GRC (#113), and deposits before arrival (#114)
- @ali-qa-sudo: role-aware Walk-in / New booking buttons (#120)
- @omar99elnemr: checkout refused until the bill is settled (#132)
- @Syzygy2048: current OpenAI models in the assistant (#23)
- @archnexus707: found and responsibly disclosed cross-property access (GHSA-6cr2), fixed in 2.6.5
- @kta1kri: unauthenticated webhooks (GHSA-5hcx) and an independent report of GHSA-6cr2, both fixed in 2.6.5
Kamra means "room". The door in our logo is open on purpose.