mcp-smoobu

MCP server for the Smoobu property management API. Provides 27 tools (16 read + 11 write) to manage reservations, properties, guests, rates, and messages through the Model Context Protocol.

Features

• User — Account information
• Properties — List and inspect apartments
• Reservations — Create, update, cancel, list, and check availability
• Guests — Create, update, list guest profiles
• Messages — Send messages, list threads and conversation history
• Rates — Read and update pricing rates
• Addons — List available add-ons
• Placeholders — Custom and reservation placeholders
• Check-in — Online check-in data
• Price Elements — Create, update, delete price elements on reservations

Quick Start

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "smoobu": {
      "command": "npx",
      "args": ["-y", "mcp-smoobu"],
      "env": {
        "SMOOBU_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

claude mcp add smoobu -- npx -y mcp-smoobu

Then set the environment variable:

export SMOOBU_API_KEY="your-api-key"

Authentication

Set the SMOOBU_API_KEY environment variable with your Smoobu API key. You can find it in your Smoobu Settings.

Tools

Read Tools (16)

| Tool | Description | |------|-------------| | get_user | Get current user/account info | | list_apartments | List all apartments | | get_apartment | Get apartment details | | list_reservations | List reservations with filters | | get_reservation | Get reservation details | | get_reservation_price_elements | Get price elements for a reservation | | get_reservation_placeholders | Get placeholder values for a reservation | | list_guests | List all guests | | get_guest | Get guest details | | list_reservation_messages | List messages for a reservation | | list_threads | List message threads | | list_rates | List rates for an apartment | | list_addons | List available add-ons | | list_custom_placeholders | List custom placeholders | | get_custom_placeholder | Get a custom placeholder | | list_online_check_ins | List online check-ins |

Write Tools (11)

| Tool | Description | |------|-------------| | check_apartment_availability | Check apartment availability for dates | | send_reservation_message | Send a message for a reservation | | create_guest | Create a new guest | | update_guest | Update guest details | | create_reservation | Create a new reservation | | update_reservation | Update a reservation | | cancel_reservation | Cancel a reservation | | create_price_element | Add a price element to a reservation | | update_price_element | Update a price element | | delete_price_element | Delete a price element | | update_rates | Update rates for an apartment |

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Watch mode
npm run dev

API Documentation

See the official Smoobu API documentation for details on endpoints and data models.

License

MIT © Morgan Demoulin