Lettr MCP Server

MCP server for the Lettr email API — send transactional emails, manage templates, domains, and webhooks from any AI assistant

Local serverstdioPython

What is the Lettr MCP Server?

MCP server for the Lettr email API — send transactional emails, manage templates, domains, and webhooks from any AI assistant

What you get

Lettr is a modern email sending platform built for developers. It offers a clean REST API, a powerful drag-and-drop template editor, merge tag personalization, open and click tracking, and best-in-class deliverability. Whether you're sending password resets, order confirmations, or onboarding sequences, Lettr makes it simple and reliable.

  • API Reference — — Full REST API documentation
  • Templates — — Visual email editor with merge tags
  • Domains — — Domain verification and DNS setup
  • Webhooks — — Real-time event notifications
  • Quickstart Guides — — Node.js, PHP, Laravel, Python, Go, Rust, and more

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
send-emailSend a transactional email with HTML, plain text, templates, attachments, tracking, and personalization
list-emailsList recently sent emails (cursor-paginated, with recipient and date filters)
list-email-eventsList email events (delivery, bounce, click, open, …) with filters by type, recipient, transmission, and date range
get-email-detailRetrieve the full delivery timeline for a single transmission by request ID
schedule-emailSchedule a transactional email for future delivery (5+ minutes ahead, within 30 days)
list-scheduled-emailsList emails waiting to be sent, with a state filter
get-scheduled-emailGet the state and events of a scheduled email
cancel-scheduled-emailCancel a scheduled email before it is sent
list-templatesList email templates, filterable by purpose and folder
get-templateGet full template details including HTML content
create-templateCreate a new template with HTML or visual editor JSON, transactional or campaign
update-templateUpdate template name and/or content (creates new version)
delete-templatePermanently delete a template and all versions
get-merge-tagsDiscover merge tag variables a template expects
get-template-htmlRetrieve a template's rendered HTML, subject, and merge tags by project ID and slug
list-foldersList the folders templates are filed into, with purpose and template count
list-domainsList all sending domains and their verification status
create-domainRegister a new sending domain
get-domainGet domain details with DNS records
delete-domainRemove a sending domain
verify-domainTrigger DNS verification for a domain
list-webhooksList all webhook configurations
get-webhookGet webhook details and delivery status
create-webhookCreate a new webhook subscription with auth and event-type selection
update-webhookUpdate an existing webhook (name, URL, auth, events, active flag)
delete-webhookDelete a webhook subscription
list-projectsList projects owned by the team — useful for discovering project IDs
list-audience-listsList audience (contact) lists with pagination
create-audience-listCreate a new audience list
get-audience-listGet a single list and its contact count
update-audience-listRename an audience list
delete-audience-listDelete an audience list
bulk-delete-audience-listsDelete up to 50 lists in one call
list-audience-contactsList contacts with search, status, list, and segment filters
get-audience-contactGet a contact with its properties, lists, and topics
create-audience-contactCreate a contact, optionally with double opt-in
bulk-create-audience-contactsCreate many contacts, either from a flat list of emails or one row per contact
update-audience-contactUpdate a contact's email, status, or properties
delete-audience-contactDelete a contact
attach-contact-to-listAdd a contact to a list
detach-contact-from-listRemove a contact from a list
subscribe-contact-to-topicSubscribe a contact to a topic
unsubscribe-contact-from-topicUnsubscribe a contact from a topic
bulk-attach-contacts-to-listsAttach many contacts to many lists at once
bulk-detach-contacts-from-listsDetach many contacts from many lists at once
bulk-subscribe-contacts-to-topicsSubscribe many contacts to many topics at once
bulk-unsubscribe-contacts-from-topicsUnsubscribe many contacts from many topics at once
list-audience-topicsList subscription topics with pagination
create-audience-topicCreate a subscription topic
get-audience-topicGet a single topic
update-audience-topicUpdate a topic's name, description, or visibility
delete-audience-topicDelete a subscription topic
list-audience-propertiesList custom contact properties
create-audience-propertyDefine a new custom property
get-audience-propertyGet a single property
update-audience-propertyUpdate a property's fallback value
delete-audience-propertyDelete a custom property
list-audience-segmentsList segments, optionally filtered by list
create-audience-segmentCreate a segment from match conditions
get-audience-segmentGet a single segment and its conditions
update-audience-segmentUpdate a segment's name, list, or conditions
delete-audience-segmentDelete a segment
health-checkCheck the Lettr API health status
auth-checkValidate the configured API key and return the team ID

How to install the Lettr MCP Server

{
  "mcpServers": {
    "lettr": {
      "command": "npx",
      "args": [
        "-y",
        "lettr-mcp"
      ],
      "env": {
        "LETTR_API_KEY": "YOUR_LETTR_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
LETTR_API_KEYDeclared in the maintainer’s client configuration.Yes

Example prompts to try

  • “Use Lettr MCP to Cursor.”
  • “Use Lettr MCP to Options.”
  • “Use Lettr MCP to Emails.”

Frequently asked questions

MCP server for the Lettr email API — send transactional emails, manage templates, domains, and webhooks from any AI assistant Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.