# Flowmails

> Flowmails is an MCP server for communication. Hosted MCP server that lets AI agents send, receive and search email on your domain. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, Web
- **Website:** https://flowmails.net/mcp
- **Repository:** https://github.com/wms-why/flowmails-cf
- **MCP Registry name:** net.flowmails/mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

The README-style page describes a hosted Model Context Protocol endpoint that gives an agent access to email on domains you own. Once a domain and key are set up in the dashboard, an agent can list mailboxes, wait for an incoming verification message, read it and reply, all through fourteen tools.

Access is controlled per tool. Public discovery calls such as tools/list work without a credential, while any tools/call needs either an SDK key or a scoped agent credential. Each call passes a scope check before it runs, and a missing scope returns a typed error that names the scope required.

The server is aimed at teams building agents that need to handle email, such as sign-up verification flows or support triage. The account owner still creates the account, verifies the domain and mints keys, and sending has no per-message approval step, so access is governed by scopes, domain binding and revocation.

## Features

- **Hosted streamable HTTP endpoint:** Serves MCP over streamable HTTP at a single URL and supports two protocol revisions.
- **Durable inbox waiting:** Opens a wait on a mailbox and polls its status, so an agent can pick up a verification email later.
- **Scoped credentials:** Agent credentials name the tools they may call and can be revoked individually.
- **Per-tool scope checks:** Each call is checked against its scope before the tool runs, returning a typed scope_denied error when missing.
- **Message claiming and state:** Tools mark a message as being processed and record how the agent handled it.
- **Hashed key storage:** Raw credentials are not stored; lookups use the SHA-256 hash of the key.

## Good for

- Reading verification codes from email during agent-driven sign-ups
- Sending replies from a domain you own via an MCP-capable agent
- Searching a mailbox for past messages or conversation threads
- Processing inbound email events with a cursor-based event log

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://sdk.flowmails.net/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sdk.flowmails.net/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://sdk.flowmails.net/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://sdk.flowmails.net/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://sdk.flowmails.net/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://sdk.flowmails.net/mcp
```

Enter a Name (for example "Flowmails"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://sdk.flowmails.net/mcp"
    }
  }
}
```

## Tools

- `list_domains`: The domains the account owns.
- `list_addresses`: The local parts one domain accepts.
- `create_address`: Adds one local part, and nothing else.
- `search_emails`: Looks back through the mailbox.
- `get_email`: Reads the body of one message.
- `get_thread`: Reads the conversation a message belongs to.
- `send_email`: Sends from the bound domain.
- `get_send_status`: Reads the delivery status of a sent message.
- `wait_for_email`: Opens a durable wait for a mailbox.
- `get_wait_status`: Polls that wait.
- `list_events`: Reads the inbound event log with a cursor.
- `claim_message`: Takes a message for processing.
- `complete_message`: Records how the agent handled a message.
- `list_message_states`: Reads the agent's own per-message state back.

## FAQ

### Does the server require a key to list its tools?

No. The page says server/discover, tools/list and the legacy handshake answer without a key, and only tools/call needs a credential.

### How many tools does it expose?

Fourteen tools, including list_domains, send_email, wait_for_email and claim_message.

### Does sending require approval for each message?

No. The page states there is no approval step or per-message confirmation; control comes from scopes, domain binding and revocation.

### Does the server expose resources or prompts?

No. It advertises tools only and returns empty lists for the resource and prompt list methods.

### How do I add Flowmails to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://sdk.flowmails.net/mcp

### What are the best alternatives to Flowmails?

The closest alternatives to Flowmails are Flowmails MCP, Email, Mails.ai — Agent Email, Spare Email MCP and MCP.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Flowmails MCP](https://ai-powered.com/mcp/flowmails-mcp): Flowmails MCP is a freemium MCP server for communication.
- [Email](https://ai-powered.com/mcp/email): Email is an MCP server for communication.
- [Mails.ai — Agent Email](https://ai-powered.com/mcp/mails-ai-agent-email): Mails.ai — Agent Email is a freemium MCP server for communication.
- [Spare Email MCP](https://ai-powered.com/mcp/spare-email-mcp): Spare Email MCP is an open-source MCP server for communication.
- [MCP](https://ai-powered.com/mcp/mcp-33): MCP is a freemium MCP server for communication.
- [Samva MCP](https://ai-powered.com/mcp/samva-mcp): Samva MCP is a freemium MCP server for communication.
- [Mailgi](https://ai-powered.com/mcp/mailgi): Mailgi is a freemium MCP server for communication.
- [Escouade Mail](https://ai-powered.com/mcp/escouade-mail): Escouade Mail is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/flowmails
