# Minutemailer MCP > Minutemailer MCP Server handles all your email and SMS marketing tasks. Connect it to your AI client to manage contacts, organize smart lists, create new contacts on the fly, and view campaign history without leaving your chat window. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** email-campaigns, sms-marketing, contact-management, audience-segmentation, marketing-automation ## Description You gotta connect Minutemailer to your AI agent using this server. It lets you handle every damn thing in your email and SMS campaigns—all straight up through the chat window. You don't need to jump between apps; everything happens right here. **Managing Your Contacts:** You can manage your entire audience list with a few simple commands. If you know someone new, just tell your agent to `create_contact`, and it adds that brand-new person straight into your Minutemailer list. Need to clean up the roster? Use `delete_contact` to permanently pull a specific contact out of your account. To see who's in the system, run `list_contacts`; that spits out every single detail for every contact you’ve got filed away. **Organizing Your Audiences and Segments:** Grouping people is where the real money is. You can call `list_contact_lists` to see every main group you've set up. For even more targeted hits, your agent uses `list_smart_lists`. This shows you all those automatically filtered segments—the smart lists—so you know exactly who needs to see what. If you want a complete rundown of your organizational setup, `list_contact_lists` gets that info for ya. **Campaign Content and Templates:** When it comes to writing stuff, you don't wanna start from scratch every time. Just run `list_templates`, and you get a full list of every pre-written email template sitting there, ready for deployment in your next campaign. You can see what content’s already polished and waiting to go. **Checking the Books and History:** Want to verify how things are set up? Use `get_account_info` to pull general metadata about your Minutemailer account setup. If you gotta know what happened recently, run `list_events`. This gives you a history of all the important actions and events that just went down in your account. It’s like looking at the activity log for everything. **How it Works:** Your agent uses these tools to keep you working. Instead of logging into the Minutemailer dashboard, you talk to your AI client. You tell it what you need—like 'list all smart lists' or 'create contact for John Doe.' The server executes that command and spits back the data, keeping you right in the conversation flow. It’s streamlined; no hopping around needed. ## Tools ### create_contact Adds a brand new contact into your Minutemailer audience list. ### delete_contact Permanently removes a specific contact from your account. ### get_account_info Retrieves general metadata about the Minutemailer account setup. ### list_contacts Fetches and displays the details for every contact currently in your system. ### list_events Retrieves a history of account actions and important events that happened recently. ### list_contact_lists Shows a list of all contact groupings you've created in your account. ### list_smart_lists Shows all the automatically generated, filtered segments (smart lists) you have set up for targeting. ### list_templates Retrieves a list of all pre-written email templates available for your campaigns. ## Prompt Examples **Prompt:** ``` List all my Minutemailer contacts. ``` **Response:** ``` Fetching contacts... I've found 1,200 contacts in your account. Here are the most recent ones... ``` **Prompt:** ``` Add 'jane.doe@example.com' to my contact list. ``` **Response:** ``` Adding contact... Success! Jane Doe has been added to your Minutemailer audience. ``` ## Capabilities ### Manage Contacts You can create, view, or delete individual contacts in your Minutemailer audience. ### View Contact Lists and Segments The server lets you list all existing contact lists and specific smart segments for targeted outreach campaigns. ### Retrieve Account Data You can pull basic account metadata to verify setup details or check historical events. ### Browse Templates The system lists all available email templates, so your agent knows what content is ready for a campaign. ## Use Cases ### Onboarding a New Client A new client signs up and has 50 unique contacts. Instead of exporting a spreadsheet and pasting them into the web UI, they tell their agent: 'Add all these people.' The agent runs `create_contact` for each entry, getting confirmation on every single add. ### Debugging a Campaign Failure The latest campaign hit zero recipients. An agent uses `list_events` to check the last 24 hours of activity and discovers that the segment list was renamed, causing the failure. They then use `list_smart_lists` to get the correct name for next time. ### Auditing Audience Changes A manager needs to know who changed their contact lists last week. They ask their agent to run `list_events`. The server provides a chronological list of changes, allowing them to pinpoint the exact date and user who made the modification. ### Preparing for a Product Launch The marketing team has 10 draft emails ready. Instead of manually browsing the template library, they ask their agent to run `list_templates`. The server gives them an immediate list of all drafts by name and status. ## Benefits - Instantly update your audience. Instead of logging into the dashboard to add a new lead, just ask the agent to `create_contact`. It handles the API call right there in chat. - Target segments with precision. Need to work off an existing segment? Use `list_smart_lists` to view and confirm the exact name of your audience list for campaign setup. - Keep a clean audit trail. The `list_events` tool lets you check historical data, so you know exactly when contacts were added or lists changed—no digging through old logs needed. - Draft campaigns faster than ever. Instead of navigating to the templates section, running `list_templates` shows you what's available right now, letting your agent pick the perfect draft instantly. - Control your data integrity. If a contact is outdated or needs removal, use `delete_contact` and confirm it with one prompt, instead of manually finding and deleting records. ## How It Works The bottom line is that you manage your entire marketing engine from one place: your AI client. 1. Subscribe to the server and enter your Minutemailer API Token. 2. Tell your AI client exactly what you need—for example, 'List all active customer contacts' or 'Create a new contact for John Doe'. 3. The agent runs the appropriate tool against Minutemailer and sends back the data (contacts, lists, etc.) directly to your chat. ## Frequently Asked Questions **How do I check if contacts exist with the Minutemailer MCP Server?** You run the `list_contacts` tool to get a full view of everyone in your system. If you only need to confirm basic account details, use `get_account_info`. **Can I see my segmented audiences with list_smart_lists?** Yes. The `list_smart_lists` tool pulls a detailed view of all the automatically generated segments you've created, helping you target campaigns precisely. **What is the difference between listing lists and smart lists? (Minutemailer MCP Server)** The `list_contact_lists` tool shows basic organizational buckets. The `list_smart_lists` tool shows dynamic segments that automatically update based on contact behavior, which is usually what you need for campaigns. **How do I add a new lead using create_contact?** Just give your agent the name and email. The `create_contact` tool handles adding that person to your system instantly, keeping your audience up to date. **How do I check if my API token is correctly connected using get_account_info?** Running `get_account_info` confirms your connection status and retrieves core account metadata. This tool verifies that your Minutemailer API token has the correct permissions to access basic account details. **Does running delete_contact permanently remove an audience member, or is it soft-deleted?** The `delete_contact` tool performs a hard deletion of the contact record. Once you call this function, the contact is removed from your active Minutemailer system and cannot be recovered. **What kind of historical data can I access using list_events?** `list_events` provides a chronological log of all account activities. You use this to track when contacts were created, lists were modified, or any other major system action occurred for auditing. **If I need to see what email templates are available for my campaign, should I use list_templates?** Yes. `list_templates` pulls a catalog of all existing email designs within your account. This lets you know exactly which pre-built formats you can select when writing a new marketing campaign. **Where do I find my API Token?** Log in to Minutemailer, go to your account settings, and look for the 'API Settings' section to generate a token.