Maroo

Manage your Maroo business from your AI assistant.

Community: Submitted by a user or imported; check the owner before granting accessOnlineNo sign-inGlobalFreeCan modify data

What it can do

  • Maroo List Businesses: List every Maroo business the authenticated user can currently access, whether its email is verified, and the effective permissions available in each. Email verification is requ
  • Maroo List Contacts: List active contacts for the selected Maroo business with server-side pagination, search, type filtering, and sorting. Use this to discover contact IDs before retrieving, updating
  • Maroo Get Contact: Retrieve one active contact by its exact Maroo contact ID.

What data it sees

Do you need an account

No: the server works without sign-in

Manage your Maroo business from your AI assistant.

The official Maroo Model Context Protocol (MCP) server connects MCP-compatible AI assistants to Maroo, the all-in-one CRM, contracts, invoicing, and payments platform for wedding and event businesses.

What you can do

  • Find and manage businesses and contacts.
  • Review leads, activity, and notes, then update lead progress or add follow-up notes.
  • Review quotes and contracts, and send quotes created from approved templates.
  • Create, update, activate, and review invoices and payment schedules.
  • Create and manage shareable payment links.
  • Send questionnaires and reminders, and review questionnaire submissions.
  • Create, copy, update, activate, and organize reusable templates.
  • Review outgoing payments and available payment methods.

The tools available to each user depend on their Maroo role, business permissions, account state, and plan.

Example prompts

  • “Show overdue invoices for my business and summarize the remaining balances.”
  • “Create a draft invoice for Jordan Lee for $2,400, due October 15.”
  • “Find new leads from the last seven days and add a follow-up note to Taylor's lead.”
  • “Send the active Wedding Coordination quote template to jordan@example.com.”
  • “List contracts that are still waiting for signatures.”
  • “Create a $500 consultation deposit payment link.”
  • “Show outgoing payments scheduled for this month.”

Your assistant should show the proposed details before consequential write actions. Review names, email addresses, amounts, dates, line items, and recipients before approving a tool call.

Connect

Setting Value
Remote MCP URL https://mcp.maroo.us/mcp
Transport Streamable HTTP
Authentication OAuth

Add the remote URL as a custom MCP server or connector in your MCP client, then sign in to Maroo and approve access. No API key or local server installation is required.

The server has been tested with ChatGPT custom connectors, Claude Desktop, Claude Code CLI, and Codex CLI.

Requirements

  • A Maroo business account.
  • Access to at least one Maroo business.
  • The appropriate Maroo role and feature permissions for each requested action.
  • A verified business email for actions that communicate with clients or modify protected business records.

Maroo currently supports U.S. businesses and USD payment workflows. Money values passed to MCP tools are represented as integer USD cents.

Safety and payments

  • The public connector does not execute or schedule outgoing fund transfers.
  • Creating an invoice or payment link does not move money. It creates a request or checkout link that a client can choose to pay later in Maroo.
  • Any future outgoing-payment creation capability will create a non-executable draft that must be reviewed and explicitly confirmed in the Maroo app before funds can move.
  • Some actions send email or create externally accessible links. Your MCP client may ask for confirmation before completing them.
  • Delete actions and irreversible state changes are identified as destructive operations.

Security and privacy

  • Authentication uses OAuth; do not paste Maroo credentials or access tokens into prompts.
  • The connector respects the same business access and feature permissions as Maroo.
  • Only connect through the official endpoint: https://mcp.maroo.us/mcp.
  • Disconnect the connector from your MCP client or revoke its Maroo authorization when it is no longer needed.

Support

Server tool list (49)

Raw names from tools/list. Only developers need these.

maroo_list_businessesList every Maroo business the authenticated user can currently access, whether its email is verified, and the effective permissions available in each. Email verification is required to create or edit invoices, payments, and payment links. Pass the returned businessId to every business-scoped tool. If several businesses are returned and the user did not identify one, ask which business to use.
maroo_list_contactsList active contacts for the selected Maroo business with server-side pagination, search, type filtering, and sorting. Use this to discover contact IDs before retrieving, updating, or deleting a contact.
maroo_get_contactRetrieve one active contact by its exact Maroo contact ID.
maroo_create_contactCreate a contact for the selected Maroo business. A matching existing or deleted contact may be updated or restored; inspect the returned action and contact ID.
maroo_update_contactUpdate a contact name or email. Changing the email may replace the contact and return a new ID; use the returned ID in subsequent calls.
maroo_delete_contactSoft-delete an active contact. The contact will no longer appear in contact queries, and deleting an absent or already deleted contact returns not found.
maroo_list_contractsList contracts for the selected Maroo business with pagination, search, status, event, date, document-kind, and sorting filters.
maroo_get_contractRetrieve one contract with participants, event details, attachments, audit trail, addendums, and linked invoices by exact Maroo contract ID.
maroo_list_payment_linksList payment links for the selected Maroo business using the existing server-side pagination, search, status filter, and sorting. Use returned IDs for subsequent CRUD calls.
maroo_get_payment_linkRetrieve one payment link, including itemized details, by its exact Maroo payment link ID.
maroo_create_payment_linkCreate a quick, legacy limited, or itemized payment link. All money is USD; convert user amounts to integer cents and do not call this tool when another currency is explicitly requested. Itemized totals are calculated by the server.
maroo_update_payment_linkUpdate an active payment link. Quick links accept description, amount, and legacy maxInvoices changes; itemized links accept name, items, discount, and tax changes. Item arrays replace the full list.
maroo_delete_payment_linkSoft-delete a payment link owned by the selected Maroo business.
maroo_list_payment_methodsList payment methods available to the selected Maroo business. Use a returned paymentMethodId when updating a payment.
maroo_list_paymentsList payments made by the selected Maroo business to its contacts.
maroo_get_paymentRetrieve one payment by its exact Maroo payment ID for the selected business.
maroo_update_paymentUpdate an editable payment. Only supplied fields are changed.
maroo_delete_paymentDelete an editable payment.
maroo_list_invoicesList invoices for the selected Maroo business, newest first. Use returned invoice and payment IDs for subsequent operations.
maroo_get_invoiceRetrieve one invoice and its complete payment schedule by exact Maroo invoice ID.
maroo_create_invoiceCreate a draft or active invoice for an existing or new contact. All money is USD; convert user amounts to integer cents and do not call this tool when another currency is explicitly requested. Active Email invoices are sent immediately; PaymentLink delivery creates a shareable link without emailing the contact.
maroo_update_invoiceUpdate an editable invoice. paymentSchedule is a complete replacement, not a patch: to remove one payment, first retrieve the invoice, resend every payment to keep with its existing ID, due date, and amount, and omit only the payment to remove. Completed or processing payments cannot be changed or removed.
maroo_activate_invoiceActivate a draft invoice. Active invoices are rejected. Email delivery sends the invoice to the client; PaymentLink delivery activates it without emailing.
maroo_delete_invoiceSoft-delete an invoice. Invoices with completed payments cannot be deleted.
maroo_mark_invoice_payment_as_paidMark an unpaid invoice payment as paid outside Maroo. This changes the invoice balance and may complete the invoice.
maroo_unmark_invoice_payment_as_paidRemove an outside-Maroo paid marker from an invoice payment. Payments completed through Maroo cannot be unmarked.
maroo_list_templatesList templates for the selected Maroo business with pagination, search, status, type, date, and sorting filters. Use returned IDs for subsequent operations.
maroo_get_templateRetrieve one template, including its complete type-specific content, by exact Maroo template ID.
maroo_create_templateCreate one draft template. All money is USD; convert user amounts to integer cents and do not call this tool when another currency is explicitly requested. content is a type-specific discriminated union; create separate calls for separate templates.
maroo_update_templateUpdate template metadata or type-specific content. content.type is required when content is supplied and cannot differ from the existing template type.
maroo_copy_templateCopy an existing template in the same business. The server chooses a unique copy name.
maroo_activate_templateActivate a draft template after server-side content and plan validation. Already activated templates are rejected.
maroo_delete_templatePermanently remove a template from normal business use.
maroo_list_leadsList leads for the selected Maroo business with pagination, search, status, assignee, service, created-date, and sorting filters. Use returned IDs for lead details, notes, and activity.
maroo_get_leadRetrieve one lead, including form answers and assignment details, by exact Maroo lead ID.
maroo_list_lead_notesList internal notes for one lead in ascending or descending creation order.
maroo_list_lead_activityList the chronological activity history for one lead.
maroo_update_leadUpdate a lead status, progress milestones, or assignee. Set assignedTo to null to unassign the lead.
maroo_add_lead_noteAdd an internal note to one lead.
maroo_list_questionnairesList sent questionnaire responses for the selected Maroo business with pagination, client search, file name, status, sent-date, and sorting filters.
maroo_get_questionnaireRetrieve one sent questionnaire response, including its questions and submitted answers, by exact response ID.
maroo_list_questionnaire_file_namesList distinct questionnaire file names that have responses in the selected Maroo business.
maroo_send_questionnaireSend a Questionnaire template to an existing or new client by email. For a new client, pass details directly and omit contactId. Use contactId only when it is the exact ID returned by a contact tool. This creates a pending response and sends an external notification.
maroo_send_questionnaire_reminderSend an external reminder email for one pending questionnaire response.
maroo_delete_questionnaireSoft-delete one questionnaire response.
maroo_list_quotesList quotes for the selected Maroo business with pagination, search, status, accepted-date, and sorting filters. Money amounts are integer USD cents.
maroo_get_quoteRetrieve one quote with client details, line items, payment schedule, tax, discount, and totals by exact Maroo quote ID.
maroo_send_quoteCreate and immediately send a quote from an active Quote template. Choose exactly one client kind: NewContact uses client details only, ExistingContact requires an exact contactId returned by a contact tool, and ExistingLead requires an exact leadId returned by a lead tool. Never invent placeholder IDs. This sends a client notification.
maroo_delete_quotePermanently remove a quote from the selected business view by exact Maroo quote ID.