Hostfully MCP Server

Reservas, calendarios, mensajes de huéspedes y solicitudes de reserva en Hostfully.

Servidor MCP alojado

npx add-mcp 'https://cotlet.dev/mcp/v1/hostfully'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Cotlet · Integrations · How it works · Security · For developers · For automation agencies · Blog · API docs · Help center · Changelog · Contact · Pricing · Sign up

Hostfully API and MCP server: Let your AI agent answer booking requests and guests.

Hostfully has an official REST API, the Open API v3, and no official MCP server (checked 31 Oct 2026). It is a paid add-on: you email api@hostfully.com with your use case, test in a sandbox, and only then get production access. Cotlet runs 11 Hostfully tools hosted in your own login, over MCP for agents and REST for scripts.

Reservations, booking requests, calendars and guest messages for your Hostfully account. Use MCP with your AI agent or REST with HTTP workflows and scripts, without the Open API add-on.

MCP setup REST API guide

What can you automate in Hostfully?

  • Answer booking requests
  • Reply to guest messages
  • Brief you on arrivals
  • Find gaps in the calendar
  • Update seasonal rates
  • Flag unanswered guests

Does Hostfully have an MCP server or an API?

  • The API covers most of this page: properties, leads and bookings (accept, decline, cancel), messages, property calendars and pricing periods. Hostfully lists reports as not supported.
  • The pricing page shows Open API as an add-on on Growth (from $15 a property a month), Pro (from $25) and Enterprise, with no price for the add-on. The default limit is 1000 calls an hour.
  • It is raw endpoints: you or a developer build the calls and the agent connection. The one MCP server on GitHub we found is a generated client with 0 stars and also needs the API key.
What you needOpen API add-onGitHub serverCotlet
Read reservations, calendars, messagesYesYes, with an API keyYes
Accept or decline requests, send messages, set ratesYesYes, with an API keyYes, guest-facing actions after your OK
How you get accessEmail, sandbox work, then productionSame keyYour own Hostfully login
Extra cost on your Hostfully planAdd-on, price not publishedSame add-onNone, pay per call
Works in Claude or ChatGPTYou build itYou install and host itYes
Allowed by Hostfully's termsYes, officialYes, official APIUses the web app

Checked 31 Oct 2026. Sources: Hostfully: Open API, Hostfully Help: FAQs about Hostfully APIs, Hostfully API v3 documentation, Hostfully pricing, Hostfully Terms of Service

How does Cotlet connect to Hostfully?

  1. Sign in to Hostfully. Use your own account in its Cotlet Cloud Browser.
  2. Choose MCP or REST. Connect your agent or create a Cotlet API key.
  3. Run your workflow. Ask your agent or send an HTTP request.

We never keep your Hostfully password, and no message reaches a guest until you approve it.

Connect Hostfully to your agent or workflow

Use MCP with your AI agent, or HTTP requests in n8n, Make, Zapier and scripts. Follow the MCP setup below or jump to the REST guide.

  1. Sign in to Hostfully in a Cloud Browser. Make a Cotlet account, open Hostfully in its Cloud Browser, log in with your usual Hostfully user and press Enable for agents.
  2. Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 where your agent takes an MCP server or a connector.
  3. Finish the sign-in. Claude and ChatGPT open a Cotlet sign-in page. Cursor, Codex, n8n and scripts use an API key from the console.

One address, https://cotlet.dev/mcp/v1, serves Hostfully and the other apps you enable. Enabled Hostfully after you connected? Refresh the connector so the new tools load.

Claude:

Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet-hostfully \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"

ChatGPT:

Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth

Cursor:

// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet-hostfully": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet-hostfully]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"

n8n:

MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: hostfully_read

Make, Zapier:

Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: hostfully_write

How to use the Hostfully REST API

Create your Cotlet API key

Create a Cotlet API key with access to Hostfully and its read operations. Store it as COTLET_API_KEY in your environment or automation platform's credential store.

Connect Hostfully in Cotlet and enable it for agents. Account access: Your own Hostfully account (an agency user with access to the properties you want the agent to work on).

Make your first Hostfully API request

REST:

curl "https://cotlet.dev/api/v1/hostfully/reservations?status=request&check_in_from=2026-11-01" \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read open booking requests and apply the operation limits

A successful REST call puts the tool output in result. This illustrative response excerpt omits call IDs, messages and credit details.

Illustrative response excerpt:

{
  "status": "success",
  "app": "hostfully",
  "tool": "list_reservations",
  "result": {
    "reservations": [
      {
        "reservation_id": "r-5502",
        "property": "Garden Cottage",
        "guest": "Marcus",
        "check_in": "2026-11-05",
        "nights": 3,
        "status": "request",
        "channel": "Direct"
      }
    ]
  }
}

Returns each reservation with guest first name, property, dates, nights, status and channel, ordered by check-in date. Guest contact details come only from get_reservation.

You see the properties your Hostfully user can open. Leave status empty to list every status.

Replace the dates with your own range. Hostfully's own Open API has a default limit of 1000 calls an hour; Cotlet works from your signed-in session instead.

When you refresh a destination, compare changed values such as status and dates as well as reservation_id: a request becomes a booking, and a stay can be moved.

Hostfully workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestPost the guest threads waiting for a reply to Slack. Use list_message_threads with unanswered set to true on your own schedule.
MakeHTTP > Make a requestCheck one property for open nights before a holiday. Use get_calendar for a date range and write the gaps to a sheet.
Python or Node.jsREST APIBuild a morning list of arrivals. Use list_reservations with check_in_from and check_in_to and print it or send it by email.

Send Authorization: Bearer <your Cotlet API key> in request headers. You configure the schedule, destination and record comparisons.

Cotlet reads Hostfully; your workflow steps write to your chosen destination. These HTTP workflows do not require a native Cotlet connector or a prebuilt template.

Python and Node.js can use the same HTTP requests without an AI agent. Keep access keys in credentials, outside shared workflow exports.

The API and MCP reference lists operations and inputs. The REST API guide explains authentication, errors and approvals.

Hostfully API endpoints and MCP tools

Properties and calendar

You see the properties your Hostfully user can open. A rate change replaces the rate for the nights in the range.

  • List properties (list_properties, read): List the properties of your Hostfully account.
  • Read Central Calendar (get_calendar, read): Read the nights of one property: booked, blocked and open, with the nightly rate.
  • Set pricing period (set_pricing_period, write, asks first): Set the nightly rate of a property for a date range.

Reservations and booking requests

Accept and decline work only on reservations with status request. Cancelling a booking applies the refund terms of that booking.

  • List reservations (list_reservations, read): List reservations and booking requests, filtered by status and check-in dates.
  • Get reservation (get_reservation, read): Read one reservation with its guests, price and notes.
  • Accept booking request (accept_booking_request, write, asks first): Accept an open booking request.
  • Decline booking request (decline_booking_request, write, asks first): Decline an open booking request.
  • Cancel booking (cancel_booking, write, asks first): Cancel a confirmed booking.

Guest messages

Threads come from the Unified Inbox, newest first. Reading marks nothing as read; a sent message reaches the guest on the channel of the booking.

  • List message threads (list_message_threads, read): List guest conversations from the Unified Inbox.
  • List messages (list_messages, read): Read the messages of one thread, oldest first.
  • Send guest message (send_message, write, asks first): Send a message to a guest in the thread of a reservation.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/hostfully-api-mcp-server#tools

Who can see my Hostfully session, and how do I revoke it?

  • What we store. Your signed-in Hostfully profile, AES-256-GCM, in Finland. Not your password.
  • What your agent gets. The 11 Hostfully tools. No cookie, no API key.
  • What the session sees. The properties, reservations and messages your Hostfully role opens.
  • What no tool touches. Billing, payouts, owners, users and channel connections.
  • If Hostfully logs you out. Your agent gets a link and you log in again. We never log in for you.
  • How to cut access. Disable Hostfully for agents, reset the browser or delete the API key.

Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results); no SOC 2 report or third-party pentest yet.

Is it against Hostfully's terms? Account safety

You may use the Service only for your business purposes and shall not: ... (iv) interfere with or disrupt the integrity or performance of the Service or the data contained therein; or (v) attempt to gain unauthorized access to the Service or its related systems or networks.

Hostfully Terms of Service, section 2, last updated 8 Dec 2025

The same section bars spam and duplicative or unsolicited messages, and says you are responsible for all activity under your user account. No clause names bots, scraping or AI agents. We found no public case of a Hostfully account closed for automation, and no separate API terms (checked 31 Oct 2026). Hostfully may end an account that breaches the agreement.

How we keep your account looking like you:

  • Your own Hostfully user, logged in by you
  • One Cloud Browser with its own IP and cookies
  • Guest messages and booking decisions wait for your OK
  • No tool touches billing, payouts or channel connections
  • If Hostfully objects, we pause the Hostfully tools for everyone within 24 h

Do not use an agent to send the same message to many guests; the terms bar duplicative messages. Keep replies tied to one guest and one reservation.

What happens when Hostfully changes?

  • 12 h between tests of the Hostfully reads
  • $0 for a call to a Hostfully tool paused for repair

If Hostfully moves a screen or renames a field in the Booking Pipeline or the Unified Inbox, we change the tool and the same prompt keeps working. status.cotlet.dev watches the site, console and API every 3 minutes.

Approvals, undo and mistakes

  1. Lists open requests. For the properties you named, with dates and guest counts.
  2. Checks your rules. Minimum nights, dates and notes you put in the prompt.
  3. Waits for your OK. Each accept or decline shows up in your Cotlet console first.
  4. Reports back. What was accepted, declined or left for you.
ActionUndo
Send a guest messageNo; the guest has it
Accept or decline a requestNot through Cotlet; use the booking in Hostfully
Cancel a bookingNot through Cotlet; the guest is notified
Set a pricing periodYes, set the old rate; read it first with get_calendar
Every readNothing to undo; reads change nothing

5 of 11 tools ask first: every write, because each one reaches a guest or changes what guests pay. Turn the wait off per tool for a scheduled run you trust.

Check the nights in the calendar before you approve a rate change: it replaces the rate for the whole range.

MCP call:

{
  "name": "send_message",
  "arguments": {
    "thread_id": "t-301",
    "text": "Hi Elena, check-in starts at 3 pm. Happy to arrange earlier if the loft is free."
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/hostfully/threads/t-301/messages \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hi Elena, check-in starts at 3 pm. Happy to arrange earlier if the loft is free."}'

Response:

{
  "thread_id": "t-301",
  "status": "sent",
  "sent_at": "2026-10-31T08:15:00Z"
}

Scripts and cron jobs reach the same tools over REST at /api/v1/hostfully, with one key and one price. A write waits for your approval and answers 202 with status pending until you decide. The tools table lists the REST path of each tool.

How much does the Hostfully MCP server cost?

About $22 a month for a host with 3 properties, 3,790 credits. Your Hostfully plan stays as it is.

JobCallsCredits
Open booking requests, daily2 × 30600
Unanswered guest threads and replies, daily3 × 30900
Arrivals in the next 3 days, daily2 × 30600
Calendar gaps for 3 properties, weekly4 × 4160
One seasonal rate change, monthly3 × 130
Cloud Browser, 30 days1,500
Total3,790
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • No Open API add-on needed

The month is our example: 3 properties on Growth, which Hostfully lists from $15 a property a month plus a platform fee (pricing page, 31 Oct 2026), with daily checks. The Open API add-on has no published price. Dollars at the $29 pack rate.

Hostfully MCP server on GitHub or hosted: which to use

OptionWhat it doesWhere it stops
th1-ai/hostfully-pp-cliA generated Go CLI and MCP server for API v3.3 with a local SQLite mirror, Apache-2.0.Needs the Open API key; 0 stars, last push 8 Jun 2026; you install and host it.
Hostfully Open APIThe official REST API for properties, leads, messages, calendars and pricing.Paid add-on enabled by email; raw endpoints, no agent connection; 1000 calls an hour by default.

With the add-on and a developer, the API reaches everything on this page directly. Cotlet fits a host without the add-on or a developer: it works in your own Hostfully login and puts guest-facing actions behind your OK.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273) and trading since 2019. Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing) founded it. Write to contact@cotlet.dev with questions about the Hostfully tools.

Hostfully API and MCP: questions

How do I get access?

Sign up free at https://cotlet.dev, open Hostfully under Integrations in the console and log in to Hostfully in its Cloud Browser. The trial starts when you sign up and needs no card.

How do I connect Hostfully to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Hostfully once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Hostfully account through Cotlet, in their phone apps too.

What can ChatGPT do in Hostfully?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Hostfully: answer booking requests; reply to guest messages; brief me on arrivals. You ask in plain words, and anything that reaches other people waits for your OK first.

Do I need the Open API add-on for Cotlet?

No. Cotlet works from your signed-in Hostfully session, so you need only a Hostfully account. The Open API is a paid add-on that Hostfully enables after sandbox work (checked 31 Oct 2026).

Does Hostfully have webhooks?

Yes, inside the Open API: the docs have a Webhooks page. They need the same API access. Without it, run your agent on a schedule, for example a daily list_reservations.

Does it work with several properties?

Yes. Reservation and calendar tools take a property from list_properties, and you see the properties your Hostfully role opens. Ask the agent to loop over them.

Is the MCP server different from the REST API?

Only the way in. Both carry the same 11 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with Hostfully?

No. Cotlet is independent and not affiliated with Hostfully Inc.

Can I use the Hostfully API without an AI agent?

Yes. Call Cotlet's REST API from a script or an HTTP step in n8n, Make or Zapier with your Cotlet key. MCP is the alternative for AI agents; you do not need to connect an agent to use REST.


Give your AI agents your signed-in browser.

Product: Integrations · How it works · Pricing · Security

Resources: Blog · API docs · Help center · Changelog · GitHub

Solutions: For developers · For automation agencies

Company: About · AI info: company facts · Contact

Legal: Terms of service · Privacy policy · Refund policy · Acceptable use · Cookie policy · DPA · Subprocessors

Elsewhere: Status page · Cotlet on GitHub · Cotlet on X · Cotlet on LinkedIn · Cotlet on Product Hunt · Cotlet on Crunchbase · Cotlet on SaaSHub

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. About us

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.