How to Use the Apaleo MCP in Claude

Q: How does Claude Desktop handle multi-property hotel searches?

Your agent calls listproperties to fetch all hotel IDs associated with your Apaleo developer account. It then uses those IDs to execute parallel availability checks across your entire portfolio.

Q: What happens when Claude Desktop queries rate plans?

The agent executes listrateplans to pull active pricing codes directly from your PMS. It parses the rate structures and maps them to room types in your chat window.

Manage hotel bookings and guest folios directly inside Claude Desktop using live Apaleo PMS data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Apaleo MCP to Claude Desktop

Create your Vinkius account to connect Apaleo to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Apaleo with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit guest folios inside Claude Desktop

The `list_folios` tool pulls open guest balances and billing records directly into your chat window. You ask your agent to find unpaid charges, and it queries the Apaleo API to return line items instantly. To wrap up the audit, your agent calls `list_invoices` to match those folios with generated tax documents. Claude Desktop displays these financial tables in clean markdown without you needing to log into the PMS dashboard.

Real-time availability checks via MCP Server

The `check_availability` tool queries your hotel properties to return exact sellable room counts for specified dates. Your agent uses this live inventory feed to answer booking inquiries without making you open a web browser. This MCP Server connects your chat client directly to Apaleo's rate engine. Your agent runs `list_rate_plans` and `list_room_types` to pair those empty rooms with active pricing strategies in seconds.

Live reservation lookup and room status

The `list_reservations` tool fetches your front-desk arrival list directly into your conversational interface. Your agent scans guest names, check-in dates, and special requests without manual search queries. When a guest calls with a change, your agent invokes `get_reservation` and `list_rooms` to find an open room and verify their booking details. Claude Desktop handles the entire lookup through a single chat prompt.

Setup guide

Set up Apaleo MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Apaleo MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Apaleo MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under apaleo-mcp.

json

{
  "mcpServers": {
    "apaleo-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Apaleo. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Apaleo now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Apaleo MCP in Claude Desktop

Open your local configuration file and add the Apaleo MCP server to your config block. Once saved, restart Claude Desktop to see the room management tools appear under the hammer icon.

Yes, paste your hosted MCP server URL into the Custom Connectors settings in Claude Web. This allows your agent to run `list_reservations` and check guest bills on any device without running a local node process.

Your agent calls `list_properties` to fetch all hotel IDs associated with your Apaleo developer account. It then uses those IDs to execute parallel availability checks across your entire portfolio.

The agent executes `list_rate_plans` to pull active pricing codes directly from your PMS. It parses the rate structures and maps them to room types in your chat window.

Your guest folios and invoices remain protected because Vinkius executes the code in an ephemeral, zero-trust sandbox. Claude Desktop only receives the raw text output of `list_invoices` over an encrypted connection, meaning no financial data is stored on external servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript