Claw Ai Mail

by joansongjr

197 downloads
Not rated
GitHub

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)…

Details

Author
joansongjr
Downloads
197
Categories
Other

- REST API for sending, receiving, searching, and managing emails.
- First-class MCP server for Claude, Cursor, and other MCP clients.
- Real‑time email events via WebSocket streaming.
- Webhooks for callbacks on incoming mail and delivery status.
- Custom domain support or use @clawaimail.com addresses.
- Official Node.js and Python SDKs.

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": ""
        }
    }
}

ClawAIMail

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: "user@example.com",
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.