# How to integrate Mailcoach MCP with Hermes

```json
{
  "title": "How to integrate Mailcoach MCP with Hermes",
  "toolkit": "Mailcoach",
  "toolkit_slug": "mailcoach",
  "framework": "Hermes",
  "framework_slug": "hermes-agent",
  "url": "https://composio.dev/toolkits/mailcoach/framework/hermes-agent",
  "markdown_url": "https://composio.dev/toolkits/mailcoach/framework/hermes-agent.md",
  "updated_at": "2026-05-06T08:19:20.307Z"
}
```

## Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.
This guide explains the easiest and most robust way to connect your Mailcoach account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

## Also integrate Mailcoach with

- [OpenAI Agents SDK](https://composio.dev/toolkits/mailcoach/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/mailcoach/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/mailcoach/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/mailcoach/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/mailcoach/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/mailcoach/framework/openclaw)
- [CLI](https://composio.dev/toolkits/mailcoach/framework/cli)
- [Google ADK](https://composio.dev/toolkits/mailcoach/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/mailcoach/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/mailcoach/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/mailcoach/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/mailcoach/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/mailcoach/framework/crew-ai)

## TL;DR

### What is Composio Connect?
Composio Connect is a consumer offering that lets anyone plug 1,000+ applications directly into their agent harness — including Hermes. It can:
- Search and load tools from relevant toolkits on-demand, reducing context usage.
- Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
- Manage app authentication end-to-end with zero manual overhead.

## Connect Mailcoach to Hermes

### Integrating Mailcoach with Hermes
### Using Composio Connect CLI
1. Install the Composio CLI
Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

```bash
curl -fsSL https://composio.dev/install | bash
```

## What is the Mailcoach MCP server, and what's possible with it?

The Mailcoach MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Mailcoach account. It provides structured and secure access to your email marketing platform, so your agent can manage campaigns, organize subscriber lists, create templates, and automate email workflows on your behalf.
- Email campaign creation and scheduling: Direct your agent to launch new campaigns, send emails to specific lists, or set up campaign schedules based on your marketing needs.
- Subscriber list and segmentation management: Let your agent create new email lists, add or confirm subscribers, and apply tags for better audience segmentation and targeting.
- Template management and customization: Instruct your agent to create, update, or organize reusable email templates and transactional templates for efficient campaign building.
- Automated suppression and bounce handling: Have your agent add suppressions for bounced or blocked addresses, keeping your lists clean and compliant with deliverability best practices.
- Bulk subscriber import and data enrichment: Enable your agent to import subscribers via CSV, append new data to existing imports, and streamline growth of your contact lists.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `MAILCOACH_ADD_CAMPAIGN` | Add Mailcoach Campaign | Tool to create a new mailcoach campaign. use when you need to send or schedule an email campaign to a specific list or segment. |
| `MAILCOACH_ADD_EMAIL_LIST` | Add Email List | Tool to create a new email list. use when you need to manage and organize subscribers before sending campaigns. use after authentication. |
| `MAILCOACH_ADD_SUPPRESSION` | Add suppression | Tool to add a suppression entry. use after detecting a bounce, spam complaint, or manual block. |
| `MAILCOACH_ADD_TAG` | Add Tag to Email List | Tool to create a new tag within a specific email list. use after confirming the email list exists. |
| `MAILCOACH_ADD_TAGS_TO_SUBSCRIBER` | Add Tags to Subscriber | Tool to add tags to a subscriber. use after retrieving a subscriber's uuid to segment them. |
| `MAILCOACH_ADD_TEMPLATE` | Add Template | Tool to create a new email template. use after preparing template name and optional html content. |
| `MAILCOACH_ADD_TRANSACTIONAL_EMAIL_TEMPLATE` | Add Transactional Email Template | Tool to create a new template that can be used for transactional emails. |
| `MAILCOACH_APPEND_TO_SUBSCRIBER_IMPORT` | Append to Subscriber Import | Tool to append csv data to an existing subscriber import. use after retrieving a subscriber import when additional subscriber data needs to be added. |
| `MAILCOACH_CONFIRM_SUBSCRIBER` | Confirm Subscriber | Tool to confirm a subscriber’s subscription. use when finalizing the double opt-in process after they have provided subscriber details. example: "confirm subscriber with uuid 123e4567-e89b-12d3-a456-426614174000" |
| `MAILCOACH_CREATE_SUBSCRIBER_IMPORT` | Create Subscriber Import | Tool to create a new subscriber import. use when you have a prepared csv and want to upload it into an existing mailcoach email list after exporting or generating subscriber data. |
| `MAILCOACH_DELETE_CAMPAIGN` | Delete Campaign | Tool to delete a campaign by uuid. use when you need to permanently remove a campaign after confirming its identifier. |
| `MAILCOACH_DELETE_EMAIL_LIST` | Delete Email List | Tool to delete an email list by uuid. use when you need to permanently remove an email list after confirming its identifier. |
| `MAILCOACH_DELETE_SEND` | Delete Send | Tool to delete a sent item by its uuid. use after confirming the send's uuid to permanently remove it. |
| `MAILCOACH_DELETE_SUBSCRIBER` | Delete Subscriber | Tool to delete a subscriber by uuid. use when you need to permanently remove a subscriber from the system after verifying their uuid. |
| `MAILCOACH_DELETE_SUBSCRIBER_IMPORT` | Delete Subscriber Import | Tool to delete a subscriber import by its uuid. use when you need to permanently remove a subscriber import after confirming its identifier. |
| `MAILCOACH_DELETE_SUPPRESSION` | Delete Suppression | Tool to delete a suppression entry by uuid. use when you need to permanently remove a suppression after confirming its identifier. |
| `MAILCOACH_DELETE_TAG` | Delete Tag from Email List | Tool to delete a tag from an email list. use when you need to permanently remove a tag after confirming its identifiers. |
| `MAILCOACH_DELETE_TEMPLATE` | Delete Template | Tool to delete a template by uuid. use when you need to permanently remove a template after confirming its uuid. |
| `MAILCOACH_DELETE_TRANSACTIONAL_MAIL` | Delete Transactional Mail | Tool to delete a transactional mail by its uuid. use when you need to permanently remove a transactional mail after confirming its uuid. |
| `MAILCOACH_GET_ALL_CAMPAIGNS` | Get All Campaigns | Tool to retrieve all campaigns. use when you need a paginated, sortable list of campaigns matching criteria. |
| `MAILCOACH_GET_ALL_SENT_ITEMS` | Get All Sent Items | Tool to retrieve all sent items. use when you need to list and filter sent items after delivery. |
| `MAILCOACH_GET_ALL_SUBSCRIBER_IMPORTS` | Get All Subscriber Imports | Tool to retrieve all subscriber imports. use when you need a paginated list of import jobs. |
| `MAILCOACH_GET_ALL_SUPPRESSIONS` | Get All Suppressions | Tool to list all suppression entries. use when you need suppression uuids for further retrieval. |
| `MAILCOACH_GET_ALL_TAGS` | Get All Tags | Tool to retrieve all tags for a specific email list. use after confirming the email list exists. |
| `MAILCOACH_GET_ALL_TEMPLATES` | Get All Templates | Tool to retrieve all templates. use when you need a paginated list of templates with optional search and sorting. |
| `MAILCOACH_GET_ALL_TRANSACTIONAL_EMAIL_TEMPLATES` | Get All Transactional Email Templates | Tool to retrieve all transactional email templates. use when you need a paginated list of transactional templates matching your criteria. |
| `MAILCOACH_GET_EMAIL_LISTS` | Get Email Lists | Tool to retrieve all email lists. use when you need to fetch a paginated list of email lists with optional filters. |
| `MAILCOACH_GET_SPECIFIC_CAMPAIGN` | Get Specific Campaign | Tool to retrieve details of a specific mailcoach campaign. use when you need the full campaign resource by its uuid. |
| `MAILCOACH_GET_SPECIFIC_EMAIL_LIST` | Get Specific Email List | Tool to retrieve a specific email list. use when you need to fetch details by uuid. |
| `MAILCOACH_GET_SPECIFIC_SUBSCRIBER` | Get Specific Subscriber | Tool to retrieve a specific subscriber. use when you need to fetch subscriber details by uuid. |
| `MAILCOACH_GET_SPECIFIC_SUPPRESSION` | Get Specific Suppression | Tool to retrieve a specific suppression entry. use when you need to fetch suppression details by uuid or email. |
| `MAILCOACH_GET_SPECIFIC_TAG` | Get Specific Tag | Tool to retrieve details of a specific tag. use when you need to fetch tag metadata after confirming the email list and tag uuids. |
| `MAILCOACH_GET_SPECIFIC_TEMPLATE` | Get Specific Template | Tool to retrieve details of a specific template. use when you need template information by uuid. |
| `MAILCOACH_GET_TRANSACTIONAL_MAILS` | Get Transactional Mails | Tool to retrieve all transactional mail templates. use when you need a paginated list of transactional mails. |
| `MAILCOACH_REMOVE_TAGS_FROM_SUBSCRIBER` | Remove Tags from Subscriber | Tool to remove tags from a subscriber. use after retrieving a subscriber's uuid to adjust their segments. |
| `MAILCOACH_RESEND_CONFIRMATION` | Resend Subscriber Confirmation | Tool to resend confirmation email to a subscriber. use when a subscriber hasn't confirmed and you need to resend the confirmation. |
| `MAILCOACH_START_SUBSCRIBER_IMPORT` | Start Subscriber Import | Tool to start processing a subscriber import. use when you have a draft subscriber import ready to be processed. |
| `MAILCOACH_SUBSCRIBE_TO_EMAIL_LIST` | Subscribe To Email List | Tool to add or update a subscriber in an email list. use when you have subscriber details and need to subscribe them to a specific list, optionally skipping confirmation or enforcing strict mode. |
| `MAILCOACH_UNSUBSCRIBE_SUBSCRIBER` | Unsubscribe Subscriber | Tool to unsubscribe a subscriber from an email list. use when removing a subscriber upon their request after confirming details. example: "unsubscribe subscriber with uuid 123e4567-e89b-12d3-a456-426614174000" |
| `MAILCOACH_UPDATE_CAMPAIGN` | Update Campaign | Tool to update an existing mailcoach campaign. use after identifying the campaign uuid when you need to modify campaign attributes such as name, schedule, or content. |
| `MAILCOACH_UPDATE_EMAIL_LIST` | Update Email List | Tool to update an existing email list. use when you need to modify a list's configuration after verifying its uuid. |
| `MAILCOACH_UPDATE_SUBSCRIBER` | Update Subscriber | Tool to update a subscriber. use when you need to modify subscriber details after creation. |
| `MAILCOACH_UPDATE_SUBSCRIBER_IMPORT` | Update Subscriber Import | Tool to update an existing subscriber import. use when you need to modify a draft import before execution. import must be in draft status. |
| `MAILCOACH_UPDATE_TAG` | Update Tag | Tool to update an existing tag within an email list. use when you need to modify the name or visibility of a tag after verifying its existence. |
| `MAILCOACH_UPDATE_TEMPLATE` | Update Template | Tool to update an existing template's name or content. use when you need to modify a template's html or structured html by its uuid. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Mailcoach MCP server provides comprehensive access to Mailcoach operations through Composio. Once connected, Hermes can perform all major Mailcoach actions on your behalf using natural language commands.

## Complete Code

None listed.

## Conclusion

### Way Forward
With Mailcoach connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.
From here, you can extend Hermes further:
- Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
- Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
- Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.
If you run into trouble or want to share what you've built, join the [community](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options.

## How to build Mailcoach MCP Agent with another framework

- [OpenAI Agents SDK](https://composio.dev/toolkits/mailcoach/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/mailcoach/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/mailcoach/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/mailcoach/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/mailcoach/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/mailcoach/framework/openclaw)
- [CLI](https://composio.dev/toolkits/mailcoach/framework/cli)
- [Google ADK](https://composio.dev/toolkits/mailcoach/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/mailcoach/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/mailcoach/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/mailcoach/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/mailcoach/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/mailcoach/framework/crew-ai)

## Related Toolkits

- [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.
- [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages.
- [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections.
- [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach.
- [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.
- [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic.
- [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns.
- [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active.
- [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place.
- [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES.
- [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere.
- [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools.
- [Campayn](https://composio.dev/toolkits/campayn) - Campayn is an email marketing platform for creating, sending, and managing campaigns. It helps businesses engage contacts and grow audiences with easy-to-use tools.
- [Cardly](https://composio.dev/toolkits/cardly) - Cardly is a platform for creating and sending personalized direct mail to customers. It helps businesses break through the digital clutter by getting real engagement via physical mailboxes.
- [ClickSend](https://composio.dev/toolkits/clicksend) - ClickSend is a cloud-based SMS and email marketing platform for businesses. It streamlines communication by enabling quick message delivery and contact management.
- [Crustdata](https://composio.dev/toolkits/crustdata) - CrustData is an AI-powered data intelligence platform for real-time company and people data. It helps B2B sales teams, AI SDRs, and investors react to live business signals.
- [Curated](https://composio.dev/toolkits/curated) - Curated is a platform for collecting, curating, and publishing newsletters. It streamlines content aggregation and distribution for creators and teams.
- [Customerio](https://composio.dev/toolkits/customerio) - Customer.io is a customer engagement platform for targeted messaging across email, SMS, and push. Easily automate, segment, and track communications with your audience.
- [Cutt ly](https://composio.dev/toolkits/cutt_ly) - Cutt.ly is a URL shortening service for managing and analyzing links. Streamline your workflows with quick, trackable, and branded short URLs.
- [Demio](https://composio.dev/toolkits/demio) - Demio is webinar software built for marketers, offering both live and automated sessions with interactive features. It helps teams engage audiences and optimize lead generation through detailed analytics.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Mailcoach MCP?

With a standalone Mailcoach MCP server, the agents and LLMs can only access a fixed set of Mailcoach tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Mailcoach and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Hermes?

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Mailcoach tools.

### Can I manage the permissions and scopes for Mailcoach while using Tool Router?

Yes, absolutely. You can configure which Mailcoach scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Mailcoach data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)