Thryv MCP Server

Clients, appointments, invoices and messages in Thryv.

Hosted MCP Server

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

Installs into Claude Code, Codex, Cursor and more

Documentation

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

Thryv API and MCP server: Let your AI agent clear your Thryv inbox and calendar.

Thryv Business Center has no public API and no official MCP server (checked 27 Oct 2026). The Thryv developer portal documents Keap, the separate CRM Thryv owns, not your Business Center clients, calendar or invoices. Cotlet runs 14 Thryv tools hosted, over MCP for agents and REST for scripts.

Clients, appointments, invoices and messages in Thryv. Use it in ChatGPT, Claude or any AI agent over MCP, or in n8n, Make and scripts over REST.

MCP setup REST API guide

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by Thryv. Thryv is a trademark of its owner. If Thryv's own integrations cover what you need, use them first.

What can you automate in Thryv?

  • Book appointments from inbox messages
  • Draft estimates from quote requests
  • Invoice finished visits
  • Reply to new online reviews
  • Message clients by tag
  • Brief you on tomorrow and unpaid bills

Does Thryv have an MCP server or an API?

  • The only official link is Zapier: 4 triggers (new appointment, client, invoice, payment) and 3 actions (create a client, a busy time or a conversation). Only the primary admin can see the token it needs.
  • Nothing official books an appointment for a client, writes an estimate or invoice, reads the inbox or replies to a review.
  • No Thryv MCP server or client library exists on GitHub, and n8n, Composio and Pipedream have no Thryv app.
What you needThryv + ZapierCotlet
Add or find a clientYesYes
Book an appointment for a clientBusy time onlyYes, after your OK
Create an estimate or invoiceNew-invoice trigger onlyYes, after your OK
Read the inbox, reply to reviewsNoYes
Who can set it upPrimary adminAny user who signs in

Checked 27 Oct 2026. Sources: Thryv Help: Zapier Integrations Overview, Thryv Help: How To Grab Zapier API Token, Thryv integrations on Zapier, Thryv developer portal (Keap), Zapier MCP for Thryv

How does Cotlet connect to Thryv?

  1. Sign in to Thryv. 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 Thryv password, and no booking, estimate, invoice, message or review reply goes out until you approve it.

Connect Thryv 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. Enable Thryv for agents. Make a Cotlet account, open Thryv in its Cloud Browser, sign in to Business Center, then press Enable for agents.
  2. Add the Cotlet address. Put https://cotlet.dev/mcp/v1 into your agent's settings as a remote MCP server or custom connector.
  3. Approve the connection. Chat apps send you to a Cotlet sign-in page. Code editors, n8n and scripts take an API key from the console.

One address, https://cotlet.dev/mcp/v1, carries Thryv next to your other apps. You do not need the primary admin or the Zapier token: the agent sees what your own Thryv login sees. If you enable Thryv after connecting, refresh the connector so the Thryv tools appear.

Claude:

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

Claude Code:
claude mcp add --transport http cotlet-thryv \
  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-thryv": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}

Codex:

# ~/.codex/config.toml
[mcp_servers.cotlet-thryv]
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: thryv_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: thryv_write

How to use the Thryv REST API

Create your Cotlet API key

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

Connect Thryv in Cotlet and enable it for agents. Account access: Your own Thryv Business Center account (primary admin for full access).

Make your first Thryv API request

REST:

curl https://cotlet.dev/api/v1/thryv/clients \
  -H "Authorization: Bearer $COTLET_API_KEY"

Read clients 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": "thryv",
  "tool": "list_clients",
  "result": {
    "clients": [
      {
        "client_id": "cl_8f2a91",
        "name": "Sample Client",
        "email": "client@example.com",
        "phone": "+1 555 0100",
        "tags": [
          "spring"
        ]
      },
      {
        "client_id": "cl_20b4d7",
        "name": "Jordan Hale",
        "email": "jordan@example.com",
        "phone": "+1 555 0101",
        "tags": [
          "spring",
          "lawn"
        ]
      }
    ],
    "next_cursor": null
  }
}

Lists the clients on your account, newest first. Filter by name, email or tag to find a group such as everyone tagged "spring".

Pages hold up to 100 clients; pass next_cursor back as cursor for the next page.

limit: 1 to 100. Default: 50.

cursor: Next page cursor from the previous call.

Keep the same selection when continuing a list. Compare changed record values as well as identifiers when refreshing your destination.

Thryv workflows for agents and automations

ToolConnect throughExample workflow
n8nHTTP RequestCalendar appointments in a date range, with client, service, staff and price. Use list_appointments in your configured business report.
MakeHTTP > Make a requestInvoices from the Sales tab with client, total, balance due and dates. Use list_invoices in your configured business report.
Python or Node.jsREST APIReviews from the Reputation dashboard, from every connected site, with rating and whether you replied. Use list_reviews in your configured business report.

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

Cotlet reads Thryv; 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.

Thryv API endpoints and MCP tools

Clients

Search by name, email or tag first: a person who used the client portal may already have a card. A new card reaches nobody, so add_client runs at once.

  • List clients (list_clients, read): Clients with contact details and tags, newest first.
  • Get client (get_client, read): Client card: contact details, tags, notes, client details, appointments, invoices and message history.
  • Add client (add_client, write): New client card. Nothing is sent to the client.

Calendar and services

Thryv emails the booking confirmation with a calendar file as soon as the appointment saves, so booking asks first. Ranges are up to 31 days.

  • List services (list_services, read): Services from your services menu, with their saved prices.
  • List appointments (list_appointments, read): Calendar appointments in a date range, with client, service, staff and price.
  • Book appointment (book_appointment, write, asks first): New calendar appointment. Thryv emails the client a booking confirmation.
  • Mark no-show (mark_no_show, write, asks first): Mark an appointment as a no-show, before its end time. May send your missed appointment email.

Estimates and invoices

Estimates expire after 30 days by default. With send left false, an estimate or invoice stays a draft in Sales for you to finish.

  • List invoices (list_invoices, read): Invoices from the Sales tab with client, total, balance due and dates.
  • Create estimate (create_estimate, write, asks first): Itemized estimate on the client card, saved or sent for approval in the client portal.
  • Create invoice (create_invoice, write, asks first): Invoice on the client card, saved to send later or sent with an online payment link.

Inbox and messages

Threads across text, email and the channels you connected in Thryv. A message goes out under your business name.

  • List conversations (list_conversations, read): Inbox conversations with the latest messages, across email, text and other connected channels.
  • Send message (send_message, write, asks first): Message one or more clients, the same as Send Message on your dashboard.

Reviews

Replies post to Google, Facebook and the Thryv client portal. Yelp and TripAdvisor reviews are listed but answered on those sites.

  • List reviews (list_reviews, read): Reviews from the Reputation dashboard, from every connected site, with rating and whether you replied.
  • Reply to review (reply_to_review, write, asks first): Post a public reply to a review from the Reputation dashboard.

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

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

  • What we store. Your signed-in Thryv browser profile, AES-256-GCM encrypted, in Finland. Never the password.
  • What your agent gets. The 14 Thryv tools. No cookie, no login.
  • What the session sees. What your Thryv user sees: clients, calendar, sales, inbox, reviews.
  • What no tool touches. ThryvPay payments, refunds, user roles, billing and deletes.
  • If Thryv asks to verify. You enter any code yourself. We never do.
  • How to cut access. Disable for agents, reset the browser or delete the API key. The next call stops.

cotlet.dev rates A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Approvals, undo and mistakes

  1. Reads the inbox. list_conversations, keeping only threads that ask for a visit.
  2. Finds the slot. Matches the client card and the service, then checks list_appointments for clashes.
  3. Waits for your OK. Each booking shows client, service, time, staff and price in your Cotlet console.
  4. Reports the run. Booked, plus the requests left for you with the message quoted.
ActionUndo
Add a clientEdit or remove the card in Thryv
Book an appointmentCancel or move it; the confirmation email is already out
Create an estimateEdit the draft; an Approved estimate is locked
Send an invoice or messageNo, the client has it
Reply to a reviewEdit the reply in Thryv and post it again

6 of 14 tools ask first: every booking, no-show, estimate, invoice, message and review reply. Reads and new client cards run at once. Turn the wait off per tool for a scheduled run.

Set an appointment to Custom Price and the confirmation shows no amount; the client sees it only on the invoice.

MCP call:

{
  "name": "book_appointment",
  "arguments": {
    "client_id": "cl_8f2a91",
    "service": "Lawn treatment",
    "start": "2026-10-13T09:00:00-05:00",
    "staff": "Alex",
    "price_type": "fixed",
    "price": "85.00"
  }
}

REST:

curl -X POST https://cotlet.dev/api/v1/thryv/clients/cl_8f2a91/appointments \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"Lawn treatment","start":"2026-10-13T09:00:00-05:00","staff":"Alex","price_type":"fixed","price":"85.00"}'

Response:

{
  "appointment_id": "ap_51c7e0",
  "client": "Sample Client",
  "service": "Lawn treatment",
  "start": "2026-10-13T09:00:00-05:00",
  "end": "2026-10-13T10:00:00-05:00",
  "staff": "Alex",
  "price": "85.00",
  "confirmation_sent_to": [
    "client@example.com"
  ]
}

Scripts and cron jobs call the same tools over REST at /api/v1/thryv, with one key and one price. A call that fails, such as a booking on a time Thryv rejects, costs nothing. Each tool in the table above lists its REST path.

How much does the Thryv MCP server cost?

About $29 a month for a home service business booking about 40 inbox requests a month, 5,010 credits. Your Thryv plan is billed by Thryv as before.

JobCallsCredits
Book a request from the inbox4 × 401,600
Estimate draft from a quote request3 × 15450
List finished visits, each workday1 × 22220
Invoice a finished visit1 × 60600
Schedule and unpaid invoices, each morning2 × 22440
Check for new reviews, weekly1 × 440
Reply to a review1 × 880
Message clients with a tag, weekly2 × 480
Cloud Browser, 30 days1,500
Total5,010
  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • No Zapier plan and no primary admin needed

Thryv describes its typical client as 5 to 25 people, home services first; the request, invoice and review counts are our example. Business Center lists at $185 a month plus a $250 onboarding fee. Dollars at the $29 pack rate.

Thryv MCP server: Zapier, Keap or hosted

OptionWhat it doesWhere it stops
Zapier MCPCreate Client, Create Busy Time and Create Conversation as MCP tools, plus Find Client.No booking for a client, estimates, invoices, inbox reads or review replies. Needs the primary admin's token.
Keap APIThryv's documented REST API, 177 endpoints, OAuth or personal tokens.Only for Keap, a separate CRM. It does not reach Business Center data.
ThryvAISuggests three replies per review, captions, images and lead scores inside the app.A person picks and posts each reply; no outside agent can call it.
GitHubNo Thryv MCP server or client library found (gh search, 27 Oct 2026).Nothing to run yourself.

If new Thryv clients landing in a spreadsheet is all you need, Zapier does it for free. For bookings, estimates, invoices, the inbox and reviews there is no other route today, and Cotlet runs it hosted.

Also listed on: Odel, mcpbeat

Who runs Cotlet

Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), working since 2019, founded by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Thryv tools go to contact@cotlet.dev.

Thryv API and MCP: questions

How do I get access?

Sign up free at https://cotlet.dev, open Thryv under Integrations in the console and sign in to Business Center in its Cloud Browser. Your trial starts when you sign up, with no card.

How do I connect Thryv to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Thryv 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 Thryv account through Cotlet, in their phone apps too.

What can ChatGPT do in Thryv?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Thryv: daily schedule and unpaid invoices briefing; invoice completed jobs; reply to unanswered online reviews. You ask in plain words, and anything that reaches other people waits for your OK first.

Who can connect Thryv, and do I need Zapier?

No Zapier is needed. Cotlet works in your own Thryv Business Center account after you sign in once. Thryv's own Zapier token can be viewed or generated only by the primary admin, and Cotlet does not use it.

Does Thryv have webhooks?

Not for Business Center. The four Zapier triggers (new appointment, client, invoice, payment) are the only event feed. With Cotlet, run your agent on a schedule, for example a list_conversations pass every morning.

Does it work with Keap?

No. Keap has its own official API from Thryv. These tools work in Thryv Business Center only.

Is the MCP server different from the REST API?

Only in how you call it. Both carry the same 14 tools, inputs and answers, with one API key and one price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with Thryv?

No. Cotlet is independent and not affiliated with Thryv, Inc. or Keap.

Can I use the Thryv 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.