Claw Ai Mail

by joansongjr

197 downloads Not rated yet

About

# ClawAIMail **Email infrastructure for AI agents.** [![npm version](https://img.shields.io/npm/v/clawaimail.svg)](https://www.npmjs.com/package/clawaimail) [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)…

Explore

- REST API -- Send, receive, search, and manage emails with a simple JSON API.
- MCP Server -- First-class Model Context Protocol server for Claude, Cursor, and other MCP-compatible clients.
- WebSocket Streaming -- Real-time email events pushed to your agent as they happen.
- Webhooks -- HTTP callbacks on incoming mail, delivery status, and other events.
- Custom Domains -- Bring your own domain or use a @clawaimail.com address.
- SDKs -- Official Node.js and Python SDKs for rapid integration.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Claw Ai Mail
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the Node.js SDK with npm install clawaimail or the Python SDK with pip install clawaimail, then instantiate the client with your API key. For MCP-compatible clients like Claude Desktop or Cursor, add the MCP server configuration with the npx -y clawaimail-mcp command and your API key as an environment variable.

list_inboxes

List all email inboxes

create_inbox

Create a new email inbox (optional — a default inbox is auto-created if needed)

send_email

Send an email. If inbox_id is omitted, uses the default inbox (auto-created if needed).

list_messages

List messages. If inbox_id is omitted, uses the default inbox.

read_email

Read a specific email message. If inbox_id is omitted, uses the default inbox.

search_emails

Search emails by keyword. If inbox_id is omitted, uses the default inbox.

delete_inbox

Delete an inbox and all its messages

account_info

Get account info, plan limits, and usage

my_email

Get your agent's email address (auto-creates one if none exists)

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "claw ai mail": {
            "clawaimail": {
                "command": "npx",
                "args": [
                    "-y",
                    "clawaimail-mcp"
                ],
                "env": {
                    "CLAWAIMAIL_API_KEY": ""
                }
            }
        }
    }
}

McpServers

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

Email infrastructure for AI agents.

npm version
License: MIT
Documentation

---

ClawAIMail gives AI agents their own email addresses and full programmatic control over sending, receiving, and managing email. Built for developers who need reliable email primitives in agentic workflows.

Features

- REST API -- Send, receive, search, and manage emails with a simple JSON API.
- MCP Server -- First-class Model Context Protocol server for Claude, Cursor, and other MCP-compatible clients.
- WebSocket Streaming -- Real-time email events pushed to your agent as they happen.
- Webhooks -- HTTP callbacks on incoming mail, delivery status, and other events.
- Custom Domains -- Bring your own domain or use a @clawaimail.com address.
- SDKs -- Official Node.js and Python SDKs for rapid integration.

Quick Start

Node.js

npm install clawaimail
const { ClawAIMail } = require("clawaimail");

const client = new ClawAIMail({ apiKey: process.env.CLAWAIMAIL_API_KEY });

// Create a mailbox for your agent
const mailbox = await client.mailboxes.create({
name: "support-agent",
domain: "clawaimail.com",
});

// Send an email
await client.emails.send({
from: mailbox.address,
to: "[email protected]",
subject: "Hello from my AI agent",
text: "This email was sent by an autonomous agent.",
});

// List incoming emails
const inbox = await client.emails.list({
mailbox: mailbox.id,
unread: true,
});

Python

pip install clawaimail

```python
from clawaimail import ClawAIMail

client = ClawAIMail(api_key="your-api-key")

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.