Integration

TidyHQ integration

TidyHQ is membership and club management software for associations, sports clubs and community groups. Read and manage contacts (with notes, links, groups and custom fields), memberships, membership levels and subscriptions, invoices, deposits, expenses and transactions, events with tickets, certificates and packs, sessions, meetings, tasks, emails, shop products and orders, associated organisations, and webhooks with their triggered events. Tools use the V2 API wherever it covers the resource and the V1 API otherwise, as TidyHQ's guide recommends; the V1 create-group route is left out because its documented path is ambiguous, and webhook signing keys are not returned. Authentication is an OAuth 2.0 access token from a TidyHQ application (accounts.tidyhq.com), sent as a Bearer token; TidyHQ tokens do not expire.

Connect TidyHQ How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in TidyHQ.Built from the 130 TidyHQ tools below, on the connection you add once.

What you can do with TidyHQ

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Contact, 10 operations

add_contact_to_groupAdd contact to groupPUTAdds a contact to a group.
create_contactCreate contactPOSTCreates a contact in the current organisation. Send at least first_name; custom_fields takes custom field ids (from list_custom_fields) as keys.
delete_contactDelete contactDELETEDeletes a specified contact
get_associated_organization_contactGet associated organization contactGETGets a single specified contact
get_contactGet contactGETFetches a single contact by the ID. Note, you can also provide `scope` as you would on the index list, in which case we're query according to the specified ID.
list_associated_organization_contactsList associated organization contactsGETReturns a list of contacts
list_contactsList contactsGETFetchs list of all contacts in the current org, with optional lookup filtering applied.
list_contacts_in_groupList contacts in groupGETReturns a list of contacts
remove_contact_from_groupRemove contact from groupDELETERemoves a contact from a group.
update_contactUpdate contactPATCHUpdates a contact. Send only the fields to change; leave a field out to keep its current value.

Subscription, 8 operations

create_membershipCreate membershipPOSTAdds a member: creates a subscription and its membership on a membership level. send_welcome_mail and auto_assign_users can email people, so both are required. payment_type paid needs payment_method.
get_contact_membership_subscriptionGet contact membership subscriptionGETReturns a specific subscription, scoped to a given contact and membership.
get_membership_subscriptionGet membership subscriptionGETReturns a single subscription under a given membership.
get_subscriptionGet subscriptionGETRetrieves a specific, single subscription by ID.
list_contact_membership_subscriptionsList contact membership subscriptionsGETFor a given contact + membership, returns the list of subscriptions associated with them.
list_membership_subscriptionsList membership subscriptionsGETLists all of the subscriptions attached to a given membership.
list_subscriptionsList subscriptionsGETLists all subscriptions, with the given filtering applied.
renew_membershipRenew membershipPOSTAdds a subscription (for example a renewal) to an existing membership. send_welcome_mail and auto_assign_users can email people, so both are required. payment_type paid needs payment_method.

Event, 6 operations

create_eventCreate eventPOSTCreates a new event.
delete_eventDelete eventDELETERemoves a specified event
get_associated_organization_eventGet associated organization eventGETGets a single specified event
get_eventGet eventGETGets a single specified event. :::info Experimental The events endpoints are currently experimental, so some things may change while we finalise them.
list_associated_organization_eventsList associated organization eventsGETReturns a list of events
list_eventsList eventsGETReturns a list of events your organisation can access, including events shared from other organisations.

Membership, 6 operations

get_contact_membershipGet contact membershipGETGet a specified membership for a given contact.
get_membershipGet membershipGETReturns a single membership, given by the specified ID.
get_membership_level_membershipGet membership level membershipGETGets a single specified membership for a membership level
list_contact_membershipsList contact membershipsGETGets all memberships for a given single contact.
list_membership_level_membershipsList membership level membershipsGETList all memberships for a specific membership level
list_membershipsList membershipsGETList all memberships for the current organisation

Note, 6 operations

create_contact_noteCreate contact notePOSTAdds a note to a specified contact.
create_invoice_noteCreate invoice notePOSTAdds a note to a specified invoice.
create_membership_noteCreate membership notePOSTAdds a note to a specified membership.
delete_contact_noteDelete contact noteDELETEDeletes a specified note from a specified contact.
delete_invoice_noteDelete invoice noteDELETEDeletes a specified note from a specified invoice.
delete_membership_noteDelete membership noteDELETEDeletes a specified note from a specified membership.

Task, 5 operations

create_taskCreate taskPOSTCreates a new task.
delete_taskDelete taskDELETERemoves a specified task
get_taskGet taskGETGets a single specified task
list_tasksList tasksGETReturns a list of tasks
list_tasks_for_contactList tasks for contactGETReturns a list of tasks

Choice, 4 operations

create_custom_field_choiceCreate custom field choicePOSTCreates a new custom field choice.
delete_custom_field_choiceDelete custom field choiceDELETERemoves a specified custom field choice
get_custom_field_choiceGet custom field choiceGETGets a single specified custom field choice
list_custom_field_choicesList custom field choicesGETReturns a list of custom field choices

Custom field, 4 operations

create_custom_fieldCreate custom fieldPOSTCreates a new custom field.
delete_custom_fieldDelete custom fieldDELETERemoves a specified custom field
get_custom_fieldGet custom fieldGETGets a single specified custom field
list_custom_fieldsList custom fieldsGETReturns a list of all custom fields currently configured for the given organization.

Expense, 4 operations

create_expenseCreate expensePOSTCreates a new expense.
delete_expenseDelete expenseDELETERemoves a specified expense
get_expenseGet expenseGETGets a single specified expense
list_expensesList expensesGETReturns a list of expenses

Group, 4 operations

delete_groupDelete groupDELETERemoves a specified group
get_groupGet groupGETGets a single specified group.
list_contact_groupsList contact groupsGETList all groups for a specific contact
list_groupsList groupsGETList groups for the current organisation.

Invoice, 4 operations

create_invoiceCreate invoicePOSTCreates an invoice from your own line items (name, amount, quantity, account_id, tax_mode). due_date is required; contact_id names who is invoiced.
delete_invoiceDelete invoiceDELETERemoves a specified invoice
get_invoiceGet invoiceGETGets a single specified invoice
list_invoicesList invoicesGETReturns a list of all invoices

Meeting, 4 operations

get_associated_organization_meetingGet associated organization meetingGETGets a single specified meeting
get_meetingGet meetingGETGets a single specified meeting
list_associated_organization_meetingsList associated organization meetingsGETReturns a list of meetings
list_meetingsList meetingsGETReturns a list of meetings

Session, 4 operations

create_sessionCreate sessionPOSTCreates a new session.
delete_sessionDelete sessionDELETERemoves a specified session
get_sessionGet sessionGETGets a single specified session
list_sessionsList sessionsGETReturns a list of sessions

Ticket, 4 operations

create_ticketCreate ticketPOSTCreates a new ticket.
delete_ticketDelete ticketDELETERemoves a specified ticket
get_ticketGet ticketGETGets a single ticket type from any event your organisation can reach.
list_event_ticketsList event ticketsGETReturns the ticket types available on a specified event. For an event shared into your organisation, only the ticket types the owning organisation selected to share are included.

Webhook, 4 operations

create_webhookCreate webhookPOSTCreates a webhook (administrators only). With allow_state_changes true or omitted it starts disabled: call activate_webhook. The url must answer 2XX; a 405 errors the webhook at once. The signing key is not returned here.
delete_webhookDelete webhookDELETEDeletes a particular webhook. You must be an administrator to access this API.
get_webhookGet webhookGETReturns a particular webhook. You must be an administrator to access this API.
list_webhooksList webhooksGETReturns a list of webhooks. You must be an administrator to access this API.

Certificate, 3 operations

get_certificateGet certificateGETGets a single certificate from any event your organisation can reach.
list_contact_certificatesList contact certificatesGETReturns the certificates a specified contact is the attendee on, across every event your organisation can reach.
list_event_certificatesList event certificatesGETReturns the certificates issued on a specified event.

Deposit, 3 operations

create_depositCreate depositPOSTCreates a new deposit.
get_depositGet depositGETGets a single specified deposit
list_depositsList depositsGETReturns a list of deposits

Email, 3 operations

create_emailCreate emailPOSTCreates an email to the listed contacts. Treat it as sending a message: confirm the recipients, subject and body with the user first. contacts takes contact ids from list_contacts.
get_emailGet emailGETGets a single specified email
list_emailsList emailsGETReturns a list of emails

Organization, 3 operations

get_associated_organizationGet associated organizationGETGets a single specified associated organisation.
get_current_organizationGet current organizationGETReturns the organisation the current token is associated with, including their domain prefix etc.
list_associated_organizationsList associated organizationsGETReturns the list of all associated organisations attached to the current org.

Pack, 3 operations

get_packGet packGETGets a single ticket order from any event your organisation can reach.
list_contact_packsList contact packsGETReturns the ticket orders a specified contact bought, across every event your organisation can reach.
list_event_packsList event packsGETReturns the ticket orders placed on a specified event. A pack is one order, covering one or more attendees.

Admin, 2 operations

list_associated_organization_adminsList associated organization adminsGETGets the admins declared for one of your associated organisations.
list_current_organization_adminsList current organization adminsGETReturns all admins configured / provisioned for the current organisation.

Link, 2 operations

create_contact_linkCreate contact linkPOSTGiven a source contact, links them to another contact.
delete_contact_linkDelete contact linkDELETEGiven two contacts, removes the existing link between them.

Membership level, 2 operations

get_membership_levelGet membership levelGETRetrieves a single specified membership level.
list_membership_levelsList membership levelsGETReturns all membership levels currently configured for the given organisation.

Order, 2 operations

get_orderGet orderGETGets a single specified order
list_ordersList ordersGETReturns a list of orders

Payment, 2 operations

create_expense_paymentCreate expense paymentPOSTCreates a new payment for the specified expense.
create_invoice_paymentCreate invoice paymentPOSTCreates a new payment for the specified invoice.

Pricing variation, 2 operations

get_pricing_variationGet pricing variationGETGets a single pricing variation for a given membersship level.
list_pricing_variationsList pricing variationsGETWhen enabled, returns the pricing variations configured under a specified membership level along with any nested items.

Product, 2 operations

get_productGet productGETGets a single specified product
list_productsList productsGETReturns a list of products

Role, 2 operations

list_associated_organization_rolesList associated organization rolesGETGets the roles declared for one of your associated organisations.
list_current_organization_rolesList current organization rolesGETGets the roles for the current organisation

Shipping option, 2 operations

get_shipping_optionGet shipping optionGETGets a single specified shipping option
list_shipping_optionsList shipping optionsGETReturns a list of shipping options

Transaction, 2 operations

get_transactionGet transactionGETGets a single specified transaction
list_transactionsList transactionsGETReturns a list of transactions

Triggered event, 2 operations

get_triggered_eventGet triggered eventGETReturns a particular webhook event. You must be an administrator to access this API.
list_triggered_eventsList triggered eventsGETReturns a list of webhook events generated by the given organization, up to a maximum retention limit. Events are sorted newest to oldest.

Activate, 1 operation

activate_webhookActivate webhookPOSTSets a webhook to the active state, if it allows state changes. You must be an administrator to access this API.

Category, 1 operation

list_categoriesList categoriesGETReturns a list of categories

Deactivate, 1 operation

deactivate_webhookDeactivate webhookPOSTSets a webhook to the disabled state, if it allows state changes. You must be an administrator to access this API.

Decision, 1 operation

save_session_decisionSave session decisionPOSTSaves user decision about a Session.

Me, 1 operation

get_current_contactGet current contactGETReturns the contact associated with the contact whose API token you're currently using.

Sold, 1 operation

list_sold_ticketsList sold ticketsGETReturns a list of sold tickets

Showing the first 120 of 130 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use TidyHQ from Claude Code, Cursor or Codex

Connect TidyHQ in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its TidyHQ operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect TidyHQ

Create your workspace
Sign up free. Nothing to install.
Connect TidyHQ once
Add your TidyHQ connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.