SendHQ MCP Server for Claude and ChatGPT
By SendHQ
Overview
SendHQ is an email API and inbox for product teams and AI agents. This connector lets Claude work in your SendHQ workspace: read and search received and sent mail and threads, send email from your verified domains (single messages, batches, replies and attachments), manage drafts, hosted templates, labels and receiving addresses, add and verify domains and their DNS records, and investigate deliverability, bounces, complaints and suppressions. Tools that send real email or delete data are annotated as such, so you can require approval for them under Settings > Connectors > SendHQ. The connector uses its own API key, named after Claude, which you can delete under API Keys to disconnect. It cannot create or revoke API keys or change billing. Workspaces on the free integration trial can deliver only to the account email or AWS SES simulator addresses.
How to connect
- Claude: Open the SendHQ listing in the Claude connectors directory and choose Connect. Claude listing SendHQ exposes 59 tools here.
- ChatGPT: Open the SendHQ listing in the ChatGPT app directory and choose Connect. ChatGPT listing SendHQ exposes 119 tools here.
Tools
add_list_contacts
ChatGPTnotFound.archive_template
ChatGPTbulk_update_contacts
ChatGPTaction is delete (permanent) or unsubscribe (cannot be undone through the API). Apply one action to up to 10,000 contacts: the IDs in contact_ids, or everyone matching filter (the list_contacts filters). Actions: tag / untag (with tags), add_to_list / remove_from_list (with list_id), unsubscribe, delete. Adding to a list mirrors each contact's status, so nobody is resubscribed. delete needs confirm_count equal to the number of contacts it would delete: call once without it to get that count (409), confirm with the user, then repeat with it. Part of Campaigns.cancel_broadcast
ChatGPTcheck_broadcast
ChatGPTready is false while any check has level block; schedule_broadcast refuses then. Fix warn items or tell the user about them.create_automation
ChatGPTkey is its address and cannot be changed. entry says how people enter, exit_rules when they leave, and steps are the emails, each due offset_seconds after the person entered. from_address must be on a verified domain. Fails with 409 when the key is taken. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.create_broadcast
ChatGPT{{first_name}}, {{name}}, {{email}}, {{fields.plan}}, with fallbacks like {{first_name | there}}. Or pass a published hosted template. Nothing is sent until send_broadcast.create_contact
ChatGPTconsent_basis: how this person agreed to receive your email. Only add people who asked for your email. Use status: unsubscribed to record an opt-out. Addresses already suppressed or unsubscribed from the workspace are stored with that status. Fails with 409 if the email already exists.create_draft
ChatGPTdraft_id. Does not send anything.create_inbox
ChatGPTsupport@<receiving domain> on a domain whose inbound status is ready (run setup_inbound and verify_inbound first). Received mail appears in list_emails with direction in.create_label
ChatGPTskip_inbox: true to make it a bucket an agent owns: send with labels: [name] and the replies are filed into the label and kept out of the Inbox. Optional auto-filing rules file new sent/received mail (every condition on a rule must match). Set apply_to_existing to also file retained mail.create_label_rule
ChatGPTinbox_id to give a receiving address its own folder; add skip_inbox to keep it out of the Inbox.create_segment
ChatGPTmatch. Use it as a broadcast's audience.segment_id, as list_contacts segment_id, or in bulk_update_contacts filters. A workspace may have 200 segments.create_template
ChatGPTwelcome, reset, receipt, or blank). Publish it before sending by key.create_template_draft
ChatGPTdelete_attachment
ChatGPTdelete_automation
ChatGPTdelete_automation_step
ChatGPTposition from an automation. It is no longer sent or listed; records of who already received it are kept. While the automation is on, its only email cannot be removed (409). Confirm with the user first. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.delete_broadcast
ChatGPTdelete_contact
ChatGPTdelete_contact_field
ChatGPTdelete_domain
ChatGPTdelete_draft
ChatGPTdelete_email
ChatGPTdelete_inbox
ChatGPTdelete_label
ChatGPTdelete_label_rule
ChatGPTdelete_list
ChatGPTdelete_segment
ChatGPTdeliverability_account
ChatGPTdeliverability_domains
ChatGPTdeliverability_senders
ChatGPTdeliverability_stats
ChatGPTdownload_attachment
ChatGPTduplicate_broadcast
ChatGPT<name> (copy) with the same list, sender, content, audience, and tracking settings. Nothing is sent.email_delivery
ChatGPTenroll_contact
ChatGPTanchor_at (now by default). Only call it when the user asked for this person to get this sequence. The automation must be on (409 automation_not_on). Fails with 404 when the email is not a contact (add it with upsert_contact), 422 when the contact cannot be mailed, and 409 when the contact is already in it or went through it before and re-entry is not allowed. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.get_account
ChatGPTget_account_diagnostics
ChatGPTget_analytics
ChatGPTget_automation
ChatGPToverlap: the other automations that are on and currently have the same people in them, with goes_first true for one that ranks above this automation (the shared people get its emails first and wait in this one). Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.get_automation_person
ChatGPTmachine: true marks an automated request, which is not counted), and the conversion with the email it was credited to. Fails with 404 for a contact that was never in the automation. Opens and clicks are estimates: each email counts once, at its first open or click by a person, and automated requests (scanners, link previews, privacy prefetching) are never counted. Never claim that a person read an email. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.get_automation_report
ChatGPTsteps, one row per email with what it sent and what came of it. An email that was removed is listed with archived: true while it still has numbers in the range. Opens and clicks are estimates: each email counts once, at its first open or click by a person, and automated requests (scanners, link previews, privacy prefetching) are never counted. Never claim that a person read an email. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.get_automations_overview
ChatGPTheld (emails made to wait by a limit). Days on which nothing happened are in the series with zeros. Opens and clicks are estimates: each email counts once, at its first open or click by a person, and automated requests (scanners, link previews, privacy prefetching) are never counted. Never claim that a person read an email. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.get_broadcast
ChatGPTlastError explains why and nextAttemptAt says when it resumes.get_broadcast_report
ChatGPTmachine. Never claim that a person read the email. Fails with 409 for a draft.get_campaign_overview
ChatGPTdays (7-365, default 30): active, dormant, and pending subscribers, joined and left, a daily series, and the six latest broadcasts with open and click rates (bot-filtered estimates) and their average.get_contact
ChatGPTget_dns_provider
ChatGPTget_domain
ChatGPTdns_issues with fixes, and inbound status.get_domain_connect_link
ChatGPTproviders.domainConnect.available, create a signed consent URL. Give it to the human: they open it and approve the DNS change at their provider. Nothing changes until they approve. 409 if unsupported.get_draft
ChatGPTget_email
ChatGPTget_inbox
ChatGPTget_label
ChatGPTget_list
ChatGPTget_newsletter_settings
ChatGPTget_segment
ChatGPTget_sending_limits
ChatGPTmax_emails in any period_days, at least min_gap_hours apart, only between window_start and window_end (hours in the contact's time zone, or default_timezone) on weekdays (0 = Sunday to 6 = Saturday). An email that would break a limit is not dropped: it waits until the limits allow it. Also product_name and sender_name, available to every automation email as merge tags. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.get_service_health
ChatGPTget_template
ChatGPTrevision), active published release, release history, and usage. Accepts ID or key.get_thread
ChatGPTimport_contacts
ChatGPTemail column; name (or first_name/last_name) and status are recognized and other columns become custom fields. consent_basis is required and recorded on every new contact. Rows whose status says unsubscribed import as unsubscribed; existing contacts keep their status. Returns counts of accepted, created, existing, skipped (duplicates), and invalid rows with line numbers.label_email
ChatGPTlbl_… ID. Unknown names in add are created unless create is false.list_api_keys
ChatGPTpagination {offset, limit, returned, total?, has_more, next_offset}.list_automation_people
ChatGPTdid in an automation, most recent first: entered (the default: everyone who was ever in it), sent, delivered, opened, clicked, converted (their goal was credited to an email), bounced, unsubscribed, or waiting (waiting now behind a higher-priority automation). step narrows every filter except entered and waiting to one email. Each row has the contact's email and name, when they did it, their enrolment's status, and latest: the most recent thing that happened to them in the automation. counts says how many people each filter would list. Read one person's full history with get_automation_person. Opens and clicks are estimates: each email counts once, at its first open or click by a person, and automated requests (scanners, link previews, privacy prefetching) are never counted. Never claim that a person read an email. Paginated. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.list_automations
ChatGPTdraft, on, or off), how many emails it has, and totals for the last 30 days (entered, sent, delivered, opened, clicked, converted, bounced, complained, unsubscribed, held). held counts each time an email was made to wait by the sending limits, the sending hours, or the automation's daily cap. Email bodies are not included; use get_automation. For other date ranges and daily numbers use get_automation_report. Paginated. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.list_blocked_recipients
ChatGPTpagination {offset, limit, returned, total?, has_more, next_offset}.list_broadcast_recipients
ChatGPTlist_broadcasts
ChatGPTpagination.list_contact_fields
ChatGPTtext, number, date). Defined fields are known to check_broadcast's merge-tag check and typed in segment conditions. Contacts may also carry undefined keys. Paginated.list_contact_imports
ChatGPTlist_contacts
ChatGPTpagination {offset, limit, returned, has_more, next_offset}.list_domains
ChatGPTsetup_status (verified | checking | pending), per-record DNS state, and inbound status. Can be slow: unverified domains are re-checked live. Paginated: the result includes pagination {offset, limit, returned, total?, has_more, next_offset}.list_drafts
ChatGPTpagination {offset, limit, returned, total?, has_more, next_offset}.list_email_events
ChatGPTpagination {offset, limit, returned, total?, has_more, next_offset}.list_emails
ChatGPTdirection: out) and received (direction: in) email newest-first with filters. Received mail is classified: read the human inbox with direction: in, archived: false, category: primary; triage with important: true; spam is hidden unless category: spam or include_spam: true. Paginated: the result includes pagination {offset, limit, returned, total?, has_more, next_offset}.list_inboxes
ChatGPTpagination {offset, limit, returned, total?, has_more, next_offset}.list_labels
ChatGPTpagination {offset, limit, returned, total?, has_more, next_offset}.list_lists
ChatGPTlist_segments
ChatGPTcount (subscribed, non-dormant contacts in the workspace that match now) and fields, the condition fields and operators each accepts. Paginated.list_sender_reputation
ChatGPTactive, throttled (lower daily limit), or paused (sends return 423), with the reason and daily limit. Check this when sends fail with 423 or 429. Paginated: the result includes pagination {offset, limit, returned, total?, has_more, next_offset}.list_sending_identities
ChatGPTfrom.list_suppressions
ChatGPTpagination {offset, limit, returned, total?, has_more, next_offset}.list_tags
ChatGPTlist_templates
ChatGPTpagination {offset, limit, returned, total?, has_more, next_offset}.list_uploaded_images
ChatGPTmark_email
ChatGPTread, archived, category (primary, updates, spam; received mail only), and important. Reporting spam or marking important teaches SendHQ about that sender for future mail; pass learn: false to change only this message. Pass at least one field.preview_automation
ChatGPToutcome is send (the email in step would go out), scheduled (nothing is due before until), held (the email waits until until; reason is limit_cap, limit_gap, window, or daily_cap), waiting (behind the higher-priority automation in behind), skip (reason is stale, empty_field, or holdout), exit (the contact can no longer be mailed and would leave), complete, blocked (automation_off or subscription_required), or in_progress. Read-only: nothing is sent or changed. Use it before set_automation_status, or after changing limits, to see who gets which email. It applies the automation's own rules and does not foresee a refusal only a real send meets, such as the workspace's daily sending limit or a paused sender. Paginated. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.preview_segment
ChatGPTpublish_template
ChatGPTsend_email with template.key will use. Fails with 422 findings on validation errors, or 409 if it would break the live variable contract of a template already used in production.remove_list_contact
ChatGPTremove_suppression
ChatGPTrender_template
ChatGPTfindings when data violates the variable contract.report_bug
ChatGPTrequest_feature
ChatGPTrestore_template
ChatGPTschedule_broadcast
ChatGPTscheduled_at to the broadcast's audience, with the same checks as send_broadcast. Only call it when the user asked to send this broadcast at that time. The pre-send checks run now (422 with checks if one blocks). It starts within about a minute of the time; if it can no longer send then, it returns to a draft with the reason in lastError. A scheduled draft cannot be edited until unschedule_broadcast. Part of Campaigns.send_batch
ChatGPTdata[i].ok and data[i].error. One idempotency_key covers the whole batch body.send_broadcast
ChatGPTidempotency_key so a retry cannot start the send twice. Part of Campaigns.send_broadcast_test
ChatGPT[Test] to up to 5 addresses (default: the saved test recipients, or the account email), with merge tags filled from contact_id or a sample contact. Never goes to the list. Only send to addresses the user gave or owns. Limited to 100 test sends a day. Template broadcasts are tested with send_template_test. Part of Campaigns.send_broadcast_to_more
ChatGPTlimit more people in its audience who have not received it (the rest of a limited audience, or people who joined since), in its audience order. Only call it when the user asked for this. Same checks as send_broadcast; each contact still gets it at most once. Fails with 422 when everyone already got it. Pass idempotency_key so a retry cannot add people twice. Part of Campaigns.send_email
ChatGPTidempotency_key so a retry cannot send twice; a retry must reuse the same key AND an identical request, otherwise SendHQ returns 409. attachments is a convenience that creates a draft, uploads each file, and sends with that draft; it cannot be combined with idempotency_key or draft_id (use create_draft + upload_attachment + send_email with draft_id for retry-safe attachment sends). Unpaid workspaces (integration trial) can deliver only to the account email or an AWS SES simulator address, and cannot send attachments.send_template_test
ChatGPT[Test]-prefixed snapshot of the draft (or a given version) to the given recipients. Counts against usage; trial workspaces can only send to the account email or an SES simulator address.set_automation_status
ChatGPTstatus is on: from then on, everyone who enters the automation is emailed on its schedule, within the workspace's sending limits and hours (get_sending_limits), and people already in it continue. Use preview_automation to see who would get which email. Only turn it on when the user asked for this automation to start. Turning on checks an entry, a goal or exit_rules.no_goal, at least one email with a subject and content (422 automation_not_ready with problems), a sender on a verified domain (403), and an active subscription (402). off stops new entries and sending; people in it stay and continue if it is turned on again, except that an email more than stale_days overdue by then is skipped. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.set_contact_field
ChatGPTfields. Built-in merge tags (email, name, first_name, last_name, fields, unsubscribe_url) cannot be used as keys. A workspace may define 50 fields.set_inbox_forwarding
ChatGPTpending until someone there confirms. Pass forward_to: null to turn forwarding off. Forwarded copies come from the inbox address with the original sender as Reply-To.setup_inbound
ChatGPTinbound.<domain>. Returns the MX record the owner must publish; it does not edit DNS.thread_delivery
ChatGPTunschedule_broadcast
ChatGPTupdate_draft
ChatGPTupdate_inbox
ChatGPTactive / disabled.update_label
ChatGPTskip_inbox). Turning bucket mode on archives received mail already in the label.update_sending_limits
ChatGPTmax_emails, shortening min_gap_hours, or widening the hours. Automations are enabled workspace by workspace: a workspace that is not enabled gets 403 automations_not_enabled.update_template_draft
ChatGPTrevision from get_template (409 means someone else saved first; re-read and retry). This is a full replacement of draft content: omitted fields are cleared, so send every field you want to keep. Use {{variable}} placeholders.upload_attachment
ChatGPTcontent_base64. Attachments require a paid plan at send time.verify_domain
ChatGPTverified.verify_inbound
ChatGPTready when both public resolvers see it.add_domain
Claudearchive_template
Claudecreate_draft
Claudecreate_inbox
Claudecreate_label
Claudecreate_label_rule
Claudecreate_template
Claudecreate_template_draft
Claudedelete_attachment
Claudedelete_domain
Claudedelete_draft
Claudedelete_email
Claudedelete_inbox
Claudedelete_label
Claudedelete_label_rule
Claudedeliverability_stats
Claudedownload_attachment
Claudeget_account
Claudeget_analytics
Claudeget_dns_provider
Claudeget_domain
Claudeget_domain_connect_link
Claudeget_draft
Claudeget_email
Claudeget_inbox
Claudeget_label
Claudeget_service_health
Claudeget_template
Claudeget_thread
Claudelabel_email
Claudelist_api_keys
Claudelist_blocked_recipients
Claudelist_domains
Claudelist_drafts
Claudelist_email_events
Claudelist_emails
Claudelist_inboxes
Claudelist_labels
Claudelist_sender_reputation
Claudelist_sending_identities
Claudelist_suppressions
Claudelist_templates
Claudemark_email
Claudepublish_template
Clauderemove_suppression
Clauderender_template
Clauderestore_template
Claudesend_batch
Claudesend_email
Claudesend_template_test
Claudeset_inbox_forwarding
Claudesetup_inbound
Claudeupdate_draft
Claudeupdate_inbox
Claudeupdate_label
Claudeupdate_template_draft
Claudeupload_attachment
Claudeverify_domain
Claudeverify_inbound
ClaudeLinks
Similar Apps
Listed on MCP App Store
Add this badge to your site or README. It links to this page.
HTML
<a href="https://mcp-app-store.keenethics-labs.com/app/sendhq"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>
Markdown
[](https://mcp-app-store.keenethics-labs.com/app/sendhq)






