Apaleo MCP server

Connect Apaleo to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Apaleo MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the get reservation tool in Apaleo
  • Use the list units tool in Apaleo
  • Use the manage invoice tool in Apaleo
  • Use the manage company tool in Apaleo
  • Use the change room condition tool in Apaleo
  • Use the create booking tool in Apaleo

Supported Tools

get_reservation

Get Reservation

Retrieve full details of a specific reservation by its ID. Returns comprehensive information including guest details, stay dates, room assignment, pricing, services, and current status.

list_units

List Units

List rooms (units) for a property. Filter by room type, occupancy status, condition (clean/dirty/inspected), or maintenance state. Useful for housekeeping and room management workflows.

manage_invoice

Manage Invoice

Create, cancel, or mark invoices as paid. To **create** an invoice, provide a folioId. To **cancel** or **mark as paid**, provide the invoiceId. Also supports retrieving a specific invoice by ID.

manage_company

Manage Company

Create, update, delete, or list company profiles. Companies can be linked to reservations for corporate bookings. Supports searching by text and filtering by property.

change_unit_state

Change Room Condition

Update the housekeeping condition of a room (unit). Set a room to Clean, Dirty, or CleanToBeInspected. Commonly used by housekeeping apps to update room status after cleaning.

create_booking

Create Booking

Create a new booking with one or more reservations. A booking groups reservations under a single booker. Each reservation represents a separate room stay. Supports rate plan assignments, guest details, corporate codes, and pre-payments.

list_folios

List Folios

List guest folios filtered by property, reservation, or booking. Returns balance, charges, and payment summaries. Use this to find a guest's folio before posting charges or creating invoices.

list_properties

List Properties

List all properties (hotels/apartments) in the account. Returns each property's ID, name, location, and status. Use this to discover available properties before querying other resources.

manage_reservation

Manage Reservation

Perform lifecycle actions on a reservation: **amend** stay details (dates, guests, rate plan), **cancel**, **check-in**, **check-out**, **no-show**, **assign room**, or **unassign room**. Choose the action and provide relevant parameters.

list_rate_plans

List Rate Plans

List rate plans for a property. Rate plans define pricing rules and policies for reservations. Filter by property, room type, or distribution channel. Returns plan details including pricing model and restrictions.

search_offers

Search Offers

Search for available room offers for a specific property, dates, and guest configuration. Returns available rate plans with pricing, room type details, and availability. Use this to find what's available before creating a booking.

manage_folio

Manage Folio

Perform operations on a guest folio: **post a charge** (e.g., minibar, restaurant), **post a payment**, **post a refund**, or **close** the folio. Commonly used by POS systems to charge services to a guest's room.

trigger_night_audit

Trigger Night Audit

Trigger a night audit for a property. Night audit closes the current business day and processes end-of-day operations including posting daily charges, updating reservation statuses, and advancing the business date.

list_unit_groups

List Room Types

List room types (unit groups) for a property. Returns room type names, descriptions, max occupancy, and associated rate plans. Useful for understanding the room inventory structure.

list_blocks

List Blocks

List room blocks for a property. Blocks reserve a set of rooms for group bookings. Filter by property, group, status, or date range. Returns block details including allocated rooms and pick-up status.

list_reservations

List Reservations

Search and list reservations across properties. Filter by property, status, dates, room types, or text search. Returns paginated results with guest, room, and pricing details.

Connect Apaleo to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Apaleo in Metorial. In your Metorial portal, enable the Apaleo MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Apaleo tools.

Run Apaleo through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Apaleo and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Apaleo tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Apaleo

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Freeagent

Manage FreeAgent contacts, invoices, estimates, supplier bills, expenses, projects, tasks, and timeslips. Browse bank accounts and transactions, identify the connected user, download invoice PDFs, and retrieve financial reports.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Technical notes for Apaleo

Manage hotel and serviced apartment operations through a cloud-based property management system (PMS). Create, modify, cancel, and manage reservations and bookings, including check-in, check-out, no-show handling, and room assignments. Manage property inventory including units (rooms), unit groups (room types), and unit attributes. Set up and update rate plans, rates, restrictions, and availability in real-time. Handle guest folios by posting charges, payments, refunds, and allowances, and move items between folios. Create, cancel, and render invoices as PDFs. Process payments via terminals and pay-by-link, manage payment authorizations, and track transaction lifecycles including settlements, refunds, and disputes. Manage company profiles for corporate bookings. Handle group bookings and room blocks with confirmation, release, and wash operations. Subscribe to ARI (Availability, Rates, Inventory) change notifications for channel distribution. Configure property settings, services, and city taxes. Trigger night audit operations. Manage account users. Retrieve reports and accounting transaction data.

Frequently asked questions

Common questions about connecting Apaleo to AI agents with Metorial.

  1. How many tools does the Apaleo MCP server have?
    The Apaleo MCP server exposes 16 tools, including Get Reservation, List Units, Manage Invoice. Each one is governed and traced through Metorial.
  2. Apaleo exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Apaleo MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Apaleo and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Apaleo MCP server yourself or use the hosted gateway.

Connect Apaleo to production AI agents

See how Metorial gives your team governed access to Apaleo, with tracing and security controls built in.