🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

ClawAIMail MCP Server

by @joansongjr

Email infrastructure for AI agents — create inboxes, send and receive real emails, search messages, manage threads. Alternative to AgentMail with MCP server,...

TERMINAL
clawhub install clawaimail-mcp

📖 About This Skill


name: clawaimail version: 0.2.0 description: Email infrastructure for AI agents — create inboxes, send and receive real emails, search messages, manage threads. Alternative to AgentMail with MCP server, REST API, webhooks, and WebSocket streaming. author: ClawAIMail author_url: https://clawaimail.com repository: https://github.com/joansongjr/clawaimail license: MIT tags: - email - inbox - send-email - receive-email - ai-agent - mcp-server - mcp - api - automation - email-agent - mailbox - webhook - smtp

ClawAIMail - Email for AI Agents

Give your AI agent its own email address. Create inboxes, send and receive real emails, search messages, and manage threads — all through a simple API.

What it does

  • Create Inboxes: Instantly create email addresses like mybot@clawaimail.com
  • Send Emails: Send real emails from your agent's address
  • Receive Emails: Get notified when emails arrive via webhook or WebSocket
  • Read & Search: Read messages, search by keyword, track threads
  • Manage: Labels, custom domains, and more
  • Setup

    1. Get your API key at https://clawaimail.com (free tier: 3 inboxes, 3K emails/month) 2. Set your environment variable:

    CLAWAIMAIL_API_KEY=pb_your_api_key
    

    MCP Server Configuration

    {
      "mcpServers": {
        "clawaimail": {
          "command": "npx",
          "args": ["clawaimail-mcp"],
          "env": {
            "CLAWAIMAIL_API_KEY": "pb_your_api_key"
          }
        }
      }
    }
    

    Available Tools

    | Tool | Description | |------|-------------| | list_inboxes | List all your email inboxes | | create_inbox | Create a new email inbox (e.g. mybot@clawaimail.com) | | send_email | Send an email from an inbox | | list_messages | List messages in an inbox | | read_email | Read a specific email message | | search_emails | Search emails by keyword | | delete_inbox | Delete an inbox and all its messages | | account_info | Get account info, plan limits, and usage |

    Example Usage

    Create an inbox and send an email

    User: Create an email inbox called "assistant"
    Agent: [calls create_inbox with username "assistant"]
           Created inbox: assistant@clawaimail.com

    User: Send an email to john@example.com saying hello Agent: [calls send_email with to "john@example.com", subject "Hello", text "Hello from your AI assistant!"] Email sent successfully.

    Check for new messages

    User: Check my inbox for new messages
    Agent: [calls list_messages with inbox_id 1, unread true]
           You have 3 unread messages:
           1. From: jane@company.com - Subject: "Meeting tomorrow"
           2. From: support@service.com - Subject: "Your ticket #1234"
           3. From: newsletter@tech.io - Subject: "Weekly digest"
    

    Search emails

    User: Find any emails about invoices
    Agent: [calls search_emails with query "invoice"]
           Found 2 emails mentioning "invoice":
           1. From: billing@vendor.com - "Invoice #5678 - Due March 15"
           2. From: accounting@partner.org - "Updated invoice attached"
    

    Pricing

  • Free: 3 inboxes, 3K emails/month
  • Starter ($5/mo): 10 inboxes, 5K emails/month
  • Pro ($29/mo): 50 inboxes, 50K emails/month, custom domains
  • Business ($99/mo): 200 inboxes, 200K emails/month
  • Links

  • Website: https://clawaimail.com
  • API Docs: https://clawaimail.com/docs/
  • GitHub: https://github.com/joansongjr/clawaimail
  • Node.js SDK: npm install clawaimail
  • Python SDK: pip install clawaimail
  • ⚙️ Configuration

    1. Get your API key at https://clawaimail.com (free tier: 3 inboxes, 3K emails/month) 2. Set your environment variable:

    CLAWAIMAIL_API_KEY=pb_your_api_key