[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup) # 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](https://cotlet.dev/integrations/hostfully-api-mcp-server.md#connect) [REST API guide](https://cotlet.dev/integrations/hostfully-api-mcp-server.md#rest-api) - Free 7-day trial, no card - Unofficial, not affiliated with Hostfully - Page: https://cotlet.dev/integrations/hostfully-api-mcp-server ## 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 need | Open API add-on | GitHub server | Cotlet | |---|---|---|---| | Read reservations, calendars, messages | Yes | Yes, with an API key | Yes | | Accept or decline requests, send messages, set rates | Yes | Yes, with an API key | Yes, guest-facing actions after your OK | | How you get access | Email, sandbox work, then production | Same key | Your own Hostfully login | | Extra cost on your Hostfully plan | Add-on, price not published | Same add-on | None, pay per call | | Works in Claude or ChatGPT | You build it | You install and host it | Yes | | Allowed by Hostfully's terms | Yes, official | Yes, official API | Uses the web app | Checked 31 Oct 2026. Sources: [Hostfully: Open API](https://www.hostfully.com/property-management-software/features/open-api/), [Hostfully Help: FAQs about Hostfully APIs](https://help.hostfully.com/en/articles/5522872-faqs-on-hostfully-apis), [Hostfully API v3 documentation](https://dev.hostfully.com/), [Hostfully pricing](https://www.hostfully.com/pricing/property-management-software/), [Hostfully Terms of Service](https://www.hostfully.com/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, 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: 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 | Tool | Connect through | Example workflow | |---|---|---| | n8n | HTTP Request | Post the guest threads waiting for a reply to Slack. Use `list_message_threads` with `unanswered` set to true on your own schedule. | | Make | HTTP > Make a request | Check 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.js | REST API | Build 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 ` 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](https://cotlet.dev/integrations/hostfully-api-mcp-server.md#tools) lists operations and inputs. The [REST API guide](https://cotlet.dev/docs/api.md) 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](https://cotlet.dev/security.md)); 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](https://www.hostfully.com/terms-of-service/) 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](https://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. | Action | Undo | |---|---| | Send a guest message | No; the guest has it | | Accept or decline a request | Not through Cotlet; use the booking in Hostfully | | Cancel a booking | Not through Cotlet; the guest is notified | | Set a pricing period | Yes, set the old rate; read it first with get_calendar | | Every read | Nothing 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. | Job | Calls | Credits | |---|---|---| | Open booking requests, daily | 2 × 30 | 600 | | Unanswered guest threads and replies, daily | 3 × 30 | 900 | | Arrivals in the next 3 days, daily | 2 × 30 | 600 | | Calendar gaps for 3 properties, weekly | 4 × 4 | 160 | | One seasonal rate change, monthly | 3 × 1 | 30 | | Cloud Browser, 30 days | | 1,500 | | Total | | 3,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 | Option | What it does | Where it stops | |---|---|---| | [th1-ai/hostfully-pp-cli](https://github.com/th1-ai/hostfully-pp-cli) | A 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 API | The 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. ## 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 with your first app 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](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md) **Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet) **Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) **Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md) **Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors) **Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet) 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](https://cotlet.dev/about.md) 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.