Clawaimail

io.github.joansongjrPublished by GitHub account joansongjrv0.1.1Updated Oct 24, 2026

Email infrastructure for AI agents. Create inboxes, send/receive email, and search messages.

VerifiedSTDIODesktop onlyDeveloper Tools Communication & Collaboration

Server details

Identifier: io.github.joansongjr/clawaimail
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account joansongjr for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.joansongjr%2Fclawaimail.svg)](https://sourceweft.com/mcp/io.github.joansongjr%2Fclawaimail?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Gives an AI assistant its own email address so it can create mailboxes, send and receive messages, and search an inbox.

What you can do: ClawAIMail provides email infrastructure for agents. Through the MCP server the assistant can call tools such as send_email, read_inbox, search_emails, and create_mailbox without extra code. The underlying service also offers a REST API, WebSocket streaming of email events, webhooks for incoming mail and delivery status, custom domains, and Node.js and Python SDKs.
When to use it: Use it when an agent needs to send or receive email on its own behalf, for example handling support or notification mail, monitoring an inbox, or searching messages as part of a workflow. It fits agentic setups where email is a first-class primitive rather than a one-off script.
Requirements: Runs locally as a stdio process, launched with npx from the npm package clawaimail-mcp, so Node.js and network access are needed. A ClawAIMail account and API key are required, supplied through the CLAWAIMAIL_API_KEY environment variable. Desktop-only; no web executable.

Before you install

Requires a secret API key (CLAWAIMAIL_API_KEY) that grants access to the account's mailboxes and messages. The agent can send email to arbitrary recipients, create and delete mailboxes, delete emails, and register webhooks, so outgoing mail and destructive actions should be reviewed. Paid tiers exist (from $5/mo up to $99/mo) and usage limits apply; self-hosting is described as free.

Installation

In SourceWeft

Open Clawaimail in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

javascript

const { ClawAIMail } = require("clawaimail");
const client = new ClawAIMail({ apiKey: process.env.CLAWAIMAIL_API_KEY });
// Create a mailbox for your agentconst mailbox = await client.mailboxes.create({  name: "support-agent",  domain: "clawaimail.com",});
// Send an emailawait 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 emailsconst inbox = await client.emails.list({  mailbox: mailbox.id,  unread: true,});

const { ClawAIMail } = require("clawaimail");
const client = new ClawAIMail({ apiKey: process.env.CLAWAIMAIL_API_KEY });
// Create a mailbox for your agentconst mailbox = await client.mailboxes.create({  name: "support-agent",  domain: "clawaimail.com",});
// Send an emailawait 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 emailsconst inbox = await client.emails.list({  mailbox: mailbox.id,  unread: true,});

Python

python

from clawaimail import ClawAIMail
client = ClawAIMail(api_key="your-api-key")
# Create a mailboxmailbox = client.mailboxes.create(name="support-agent", domain="clawaimail.com")
# Send an emailclient.emails.send(    from_address=mailbox.address,    to="[email protected]",    subject="Hello from my AI agent",    text="This email was sent by an autonomous agent.",)
# List incoming emailsinbox = client.emails.list(mailbox=mailbox.id, unread=True)

from clawaimail import ClawAIMail
client = ClawAIMail(api_key="your-api-key")
# Create a mailboxmailbox = client.mailboxes.create(name="support-agent", domain="clawaimail.com")
# Send an emailclient.emails.send(    from_address=mailbox.address,    to="[email protected]",    subject="Hello from my AI agent",    text="This email was sent by an autonomous agent.",)
# List incoming emailsinbox = client.emails.list(mailbox=mailbox.id, unread=True)

MCP Server

ClawAIMail ships an MCP server so that Claude, Cursor, and other MCP-compatible clients can use email tools directly.

Claude Desktop

Add the following to your Claude Desktop MCP config (claude_desktop_config.json):

json

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

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

Cursor

Add to your .cursor/mcp.json:

json

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

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

Once configured, the agent can call tools like send_email, read_inbox, search_emails, and create_mailbox without any additional code.

Self-Hosting

ClawAIMail can be self-hosted for full control over your email infrastructure.

bash

# Clone the repositorygit clone https://github.com/joansongjr/clawaimail.gitcd clawaimail
# Install dependenciesnpm install
# Configure environmentcp .env.example .env# Edit .env with your SMTP credentials, database URL, and API keys
# Run database migrationsnpm run db:migrate
# Start the servernpm start

# Clone the repositorygit clone https://github.com/joansongjr/clawaimail.gitcd clawaimail
# Install dependenciesnpm install
# Configure environmentcp .env.example .env# Edit .env with your SMTP credentials, database URL, and API keys
# Run database migrationsnpm run db:migrate
# Start the servernpm start

The server will be available at http://localhost:3000 by default. See the self-hosting docs for production deployment guides (Docker, Railway, Fly.io).

API Endpoints

Method	Endpoint	Description
`POST`	`/v1/emails/send`	Send an email
`GET`	`/v1/emails`	List emails for a mailbox
`GET`	`/v1/emails/:id`	Get a single email by ID
`DELETE`	`/v1/emails/:id`	Delete an email
`POST`	`/v1/mailboxes`	Create a new mailbox
`GET`	`/v1/mailboxes`	List all mailboxes
`DELETE`	`/v1/mailboxes/:id`	Delete a mailbox
`POST`	`/v1/webhooks`	Register a webhook
`GET`	`/v1/webhooks`	List registered webhooks
`DELETE`	`/v1/webhooks/:id`	Remove a webhook
`GET`	`/v1/domains`	List verified domains
`POST`	`/v1/domains/verify`	Verify a custom domain
`GET`	`/v1/ws`	WebSocket connection for real-time events

Full API reference: clawaimail.com/docs/api

Pricing

	Free	Starter	Pro	Business
Price	$0/mo	$5/mo	$29/mo	$99/mo
Emails/month	100	5,000	50,000	500,000
Mailboxes	1	10	100	Unlimited
Custom domains	--	1	5	Unlimited
Webhooks	1	5	25	Unlimited
WebSocket	--	Yes	Yes	Yes
Support	Community	Email	Priority	Dedicated

Self-hosted deployments are free and unlimited. See clawaimail.com/pricing for details.

License

MIT -- see LICENSE for details.

Source: README.md at commit 96de265

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts