AIエージェントによる永続的なメール受信トレイの作成、ワンタイムパスワードの読み取り、およびメール送信を可能にします。
別名 MailFlat/mailflat-sdks, mailflat-sdks, mailflat-mcp
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- 236
- 最新バージョン
- 0.9.2
- 最終コミット
- 2026年11月13日
- ライセンス
- MIT
MailFlat MCPとは
AIエージェントによる永続的なメール受信トレイの作成、ワンタイムパスワードの読み取り、およびメール送信を可能にします。
プロジェクトのREADMEから生成された概要
MailFlat MCP server について
MailFlatは、AIエージェントや自動テストスイートが永続的なメール受信トレイを管理するための手段を提供します。開発者はこのサービスを利用して、複数の実行にわたって維持されるアドレスを作成できます。これは、登録フローのテストやエージェント間の通信管理に非常に有用です。一時的なメールサービスとは異なり、これらのアドレスはアクティブな状態を維持し、メッセージの保持期間をユーザー自身で制御できます。
ユーザーは、MailFlatのダッシュボードから取得したmf_live_で始まるアカウントキーを使用してサービスに接続します。mailflat-mcpパッケージを使用すると、ClaudeやCursorなどのAIアシスタントがこれらの受信トレイと直接やり取りできるようになります。このシステムは、カスタムラベルを使用した新しい受信トレイの作成、専用の取得ツールによるワンタイムパスワードの読み取り、メールの送信といった特定のタスクをサポートしています。この構成は、Python、JavaScript、Javaの各種SDKを通じて、ローカル開発環境とリモートのエージェント環境の両方で動作します。
できること
- 1OTPの自動取得AIエージェントが受信トレイから認証コードを待機・抽出することで、サインアッププロセスを完了させることができます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
MailFlat MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにMailFlat MCPをインストール
$ claude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcpCursorにMailFlat MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}VS CodeにMailFlat MCPをインストール
.vscode/mcp.json
{
"servers": {
"mailflat-sdks": {
"type": "stdio",
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}VS Code CLIにMailFlat MCPをインストール
$ code --add-mcp '{"name":"mailflat-sdks","type":"stdio","command":"uvx","args":["mailflat-mcp"],"env":{"MAILFLAT_API_KEY":"<YOUR_MAILFLAT_API_KEY>"}}'Claude DesktopにMailFlat MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}CodexにMailFlat MCPをインストール
$ codex mcp add mailflat-sdks --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' -- uvx mailflat-mcpCodex config.tomlにMailFlat MCPをインストール
~/.codex/config.toml
[mcp_servers.mailflat-sdks] command = "uvx" args = ["mailflat-mcp"] [mcp_servers.mailflat-sdks.env] MAILFLAT_API_KEY = "<YOUR_MAILFLAT_API_KEY>"
Gemini CLIにMailFlat MCPをインストール
$ gemini mcp add -s user -e 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks uvx -- mailflat-mcpGemini settings.jsonにMailFlat MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mailflat-sdks": {
"command": "uvx",
"args": [
"mailflat-mcp"
],
"env": {
"MAILFLAT_API_KEY": "<YOUR_MAILFLAT_API_KEY>"
}
}
}
}設定
MAILFLAT_API_KEY必須シークレットMailFlat API key. Create one in the dashboard under Agents.
MAILFLAT_API_URLOverride the API base URL. Defaults to https://mailflat.net.
| 名前 | 説明 | 種類 |
|---|---|---|
| MAILFLAT_API_KEY | MailFlat API key. Create one in the dashboard under Agents. | 必須シークレット |
| MAILFLAT_API_URL | Override the API base URL. Defaults to https://mailflat.net. |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能mailflat/mailflat-sdks is public and reachablegithub.com/mailflat/mailflat-sdks ↗合格
- パッケージがこのリポジトリをソースとして指定mailflat-mcp names mailflat/mailflat-sdks as sourcepypi.org/project/mailflat-mcp/ ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-11-13github.com/mailflat/mailflat-sdks ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from mailflat-mcp合格
- パッケージおよびその依存関係に重大な勧告なし31 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答未チェック
README
GitHubで見るMailFlat SDKs
Official client libraries for MailFlat: email inboxes your code owns, with one-line OTP retrieval. Built for test suites (Selenium, pytest, Playwright) and AI agents.
Addresses are permanent, so a suite does not need a fresh one per run. Only the messages expire, on a retention window you choose.
This repo holds only the open-source SDKs. The MailFlat service itself is closed-source.
Packages
| Package | For | Install |
|---|---|---|
mailflat |
Python | pip install mailflat |
@mailflat/sdk |
JavaScript / TypeScript | npm i @mailflat/sdk |
mailflat-mcp |
AI assistants (Claude, Cursor) — MCP | uvx mailflat-mcp |
@mailflat/ai-sdk |
Vercel AI SDK agents | npm i @mailflat/ai-sdk |
mailflat.langchain |
LangChain agents | pip install "mailflat[langchain]" |
mailflat-sdk (Java) |
Java / Selenium | via JitPack — see below |
Each client is a thin, typed wrapper over the same /api/v1 Agent API, so they behave identically.
Authenticate with your account key (mf_live_…) from the dashboard (Agents → API keys).
Java / Selenium (JitPack)
JitPack derives the
groupIdfrom the GitHub owner. This repo moved to the officialMailFlataccount in August 2026, so releases fromv0.4.4on publish ascom.github.MailFlat:mailflat-sdks. Earlier versions still resolve under the old coordinatecom.github.onderyentar21:mailflat-sdks; the old repo stays up for them. The client is moving to Maven Central (net.mailflat) next, which ends the owner coupling.
<repositories>
<repository><id>jitpack.io</id><url>https://jitpack.io</url></repository>
</repositories>
<dependency>
<groupId>com.github.MailFlat</groupId>
<artifactId>mailflat-sdks</artifactId>
<version>v0.8.1</version>
</dependency>
MailFlat mf = new MailFlat("mf_live_…");
Inbox inbox = mf.create("signup");
driver.findElement(By.id("email")).sendKeys(inbox.address());
String otp = inbox.waitForOtp(30); // polls until the code arrives
driver.findElement(By.id("code")).sendKeys(otp);
Quick examples
Python
from mailflat import MailFlat
mf = MailFlat(api_key="mf_live_…")
inbox = mf.create(label="signup")
otp = inbox.wait_for_otp(timeout=30)
JavaScript / TypeScript
import { MailFlat } from "@mailflat/sdk";
const mf = new MailFlat({ apiKey: process.env.MAILFLAT_API_KEY });
const inbox = await mf.create({ label: "signup" });
const otp = await inbox.waitForOtp({ timeout: 30000 });
License
MIT. The full text is in LICENSE at the repository root; each package directory carries an identical copy.
MailFlat MCPのよくある質問
MailFlat MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'MAILFLAT_API_KEY=<YOUR_MAILFLAT_API_KEY>' mailflat-sdks -- uvx mailflat-mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
MailFlat MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
MailFlatでの認証方法を教えてください。
MailFlatのダッシュボード内「Agents → API keys」から取得できる、mf_live_で始まるアカウントキーを使用して認証します。
メールアドレスは一時的なものですか?
いいえ、アドレスは永続的です。ただし、メッセージは選択した保持期間に基づいて期限切れとなります。
サポートされているプログラミング言語は何ですか?
MailFlatはPython、JavaScript/TypeScript、Java用のSDKを提供しているほか、LangChainやVercel AI SDKとの統合も可能です。