Cooper Email

Cooper Email

AI エージェント用のメール受信箱。 エージェントに cooperemail.com の独自アドレスを用意し、シンプルな HTTP API で実際のメールを送受信できます。メールが届いたときには署名付き Webhook を受け取り、エージェントが判断を必要とする場合はメールで人間に確認できます。

• Web サイト：https://cooperemail.com
• ドキュメント：https://cooperemail.com/docs
• MCP ドキュメント：https://cooperemail.com/docs/mcp
• インテグレーション：https://cooperemail.com/integrations
• 料金：https://cooperemail.com/pricing
• API リファレンス（OpenAPI 3.1）：https://cooperemail.com/openapi.json
• LLM 向け：https://cooperemail.com/llms.txt

このリポジトリには、Cooper Email のオープンソースのクライアント側コンポーネントが含まれています。TypeScript と Python の SDK、フレームワーク用ツールパッケージ、MCP クライアント設定、およびサンプルです。ホスト型サービス自体はこのリポジトリに含まれていません。

利用できる機能

• エージェント用の受信箱。 API 呼び出し 1 回で、アカウント、受信箱（[email protected]）、API キーを作成できます。ダッシュボードは不要です。
• 送受信。 テキスト、HTML、添付ファイル、スレッド、検索に対応し、client_id による冪等な送信も可能です。
• 人間参加型のタスク。 所有者を追加（メールで確認）し、progress／needs_input／done／error の更新を送信できます。返信はスレッド内で受け取り、ロングポーリングして回答できるタスクとして扱われます。返信には SPF／DKIM／DMARC の結果と verified_owner フラグが含まれます。
• Webhook。 message.received、message.sent、task.received、owner.reply に対応しています。HMAC-SHA256（x-cooper-signature: sha256=<hex>）で署名され、受信箱を 1 つに絞ってフィルターすることもできます。
• ホスト型 MCP サーバー。 https://cooperemail.com/mcp は Claude、ChatGPT、Cursor、その他の MCP クライアントで利用できます。

利用可能な場所

• 公式 MCP Registry：com.cooperemail/cooper-email
• Claude コネクターディレクトリ：コミュニティコネクター
• Claude Code プラグイン：/plugin marketplace add cooper-email/cooper-email を実行してから、/plugin install cooper-email@cooper-email を実行します
• Smithery
• Glama
• MCP Market
• mcpservers.org

対応サービス

設定ファイルを使って利用できます。ディレクトリへの掲載はまだありません。コピーして貼り付けられる設定：https://cooperemail.com/integrations

• Cursor
• VS Code
• Windsurf
• Codex CLI
• Cline
• Goose

同じ一覧は https://cooperemail.com/#available-on および https://cooperemail.com/llms.txt にも掲載されています。

Cursor プラグイン

このリポジトリは Cursor プラグイン（.cursor-plugin/plugin.json）でもあります。ホスト型 MCP サーバー https://cooperemail.com/mcp（初回利用時に OAuth でサインイン。設定にキーは不要）を登録し、skills/ の次のスキルを追加します。

スキル	対応内容
cooper-email	概要：接続、日常的なツール、メールの確認、安全性
cooper-agent-inbox	受信トレイの作成、送信、閲覧、返信、メールの待機
cooper-check-email	閲覧、検索、トリアージ、添付ファイル、既読／未読ラベル
cooper-send-email	送信、返信、転送、下書き、予約送信、冪等性のある再試行
cooper-manage-inboxes	受信トレイの作成（単一、一括、一時）、一時停止、更新、削除
cooper-owner-approval	オーナー承認済みの下書き：人がメールで送信ごとに承認
cooper-agent-signup-otp	エージェントとして登録し、メールで届いた認証コードを読む
cooper-owner-updates	オーナーへの進捗メールと日次ダイジェスト。返信はタスクになります
cooper-custom-domains	独自ドメインでの受信トレイ（Starter および Pro）
cooper-mcp	Cursor およびその他のクライアント向け MCP の設定とトラブルシューティング
cooper-agent-email-patterns	エージェントのメールに関するアーキテクチャパターンと脅威モデル
cooper-webhooks	1 回の呼び出しで使えるプッシュ Webhook、署名の確認、テストと再有効化
cooper-suppressions-bounces	バウンス、苦情、抑制リスト、送信率
cooper-idempotent-sends	冪等性キーによる安全な再試行が可能な送信と作成
cooper-sms	SMS のステータス（近日公開）と、現在利用できるメールの代替手段

一覧に掲載される前にローカルで試すには、このリポジトリを ~/.cursor/plugins/local/cooper-email にコピーし、Developer: Reload Window を実行してください。OAuth の代わりに API キーを使う方法については、skills/cooper-mcp を参照してください。

エージェントを接続する

cooper-email npm パッケージはまだ公開されていません。ホスト型 MCP サーバーに接続し、このリポジトリからスキルをインストールしてください。

ホスト型 MCP： https://cooperemail.com/mcp（Streamable HTTP）。初回利用時に OAuth でサインインするか、Authorization: Bearer coop_live_… を送信してください。クライアントごとの手順は、ホスト型 MCP サーバーへの接続を参照してください。Cursor では、上記のプラグインがこのサーバーを登録します。

スキル： 上の表に記載されている skills/ のガイドです。skills CLI でインストールできます。

npx skills add cooper-email/cooper-email --skill cooper-email

cooper-email を、この表にあるほかの名前（cooper-check-email、cooper-send-email、cooper-mcp など）に置き換えてください。スキルは ~/.agents/skills/<name>/ に書き込まれ、Claude Code の場合は ~/.claude/skills/<name>/ にも書き込まれます。

パッケージ

パッケージ	言語	インストール	ソース
cooper-email	TypeScript / JavaScript SDK	npm install cooper-email	packages/cooper-email
cooper-email	Python	pip install cooper-email	packages/cooper-email-python
cooper-email-langchain	TypeScript	npm install cooper-email-langchain	packages/langchain
cooper-email-langchain	Python	pip install cooper-email-langchain	packages/langchain-py
cooper-email-ai (Vercel AI SDK)	TypeScript	npm install cooper-email-ai	packages/ai
cooper-email-mastra	TypeScript	npm install cooper-email-mastra	packages/mastra
cooper-email-anthropic	TypeScript	npm install cooper-email-anthropic	packages/anthropic
cooper-email-anthropic	Python	pip install cooper-email-anthropic	packages/anthropic-py
cooper-email-openai-agents	TypeScript	npm install cooper-email-openai-agents	packages/openai-agents
cooper-email-openai-agents	Python	pip install cooper-email-openai-agents	packages/openai-agents-py
cooper-email-llamaindex	Python	pip install cooper-email-llamaindex	packages/llamaindex
cooper-email-crewai	Python	pip install cooper-email-crewai	packages/crewai
n8n-nodes-cooper-email	n8n コミュニティノード	npm install n8n-nodes-cooper-email	packages/n8n-nodes-cooper-email
cooper-email-openapi	OpenAPI 3.1 (Zapier, Make)	npm install cooper-email-openapi	packages/openapi

レジストリへのリリースは進行中です。パッケージがまだ npm または PyPI に公開されていない場合は、このリポジトリからインストールしてください（開発を参照）。

API キーを取得する

オンボーディングに認証は不要です。API キー（coop_live_…。表示は一度のみ）と最初の受信トレイが返されます。

curl -s -X POST https://cooperemail.com/api/v1/onboard \
  -H 'content-type: application/json' \
  -d '{"username":"my-agent"}'

キーは COOPER_API_KEY などの環境変数に保存してください。コミットしないでください。

クイックスタート：TypeScript

npm install cooper-email

import { Cooper } from "cooper-email";

const cooper = new Cooper({ apiKey: process.env.COOPER_API_KEY });

const inbox = await cooper.inboxes.create({ username: "research-bot", displayName: "Research" });

await cooper.messages.send(inbox.id, {
  to: ["[email protected]"],
  subject: "Hello from my agent",
  text: "Does Tuesday work?",
  clientId: "hello-1", // repeat-safe: the same clientId returns the original message
});

const { data: messages } = await cooper.messages.list(inbox.id, { limit: 20 });
const results = await cooper.search("tuesday");

人間が介在する場合：

await cooper.owners.add(inbox.id, { email: "[email protected]" }); // Ada confirms by email

await cooper.updates.notify({
  inboxId: inbox.id,
  kind: "needs_input",
  text: "Which vendor should I book?",
});

const tasks = await cooper.tasks.list({ inboxId: inbox.id, wait: 25 }); // long-poll, max 25 s
const task = tasks.data.find((t) => t.verified_owner && t.trusted);
if (task) await cooper.tasks.reply(task.id, { text: "Booked.", status: "done" });

完全なリファレンス：packages/cooper-email/README.md。

クイックスタート：Python

pip install cooper-email

import os
from cooper_email import Cooper

with Cooper(api_key=os.environ["COOPER_API_KEY"]) as cooper:
    inbox = cooper.inboxes.create("research-bot", display_name="Research")

    cooper.messages.send(
        inbox["id"],
        to=["[email protected]"],
        subject="Hello from my agent",
        text="Does Tuesday work?",
        client_id="hello-1",
    )

    messages = cooper.messages.list(inbox["id"], limit=20)
    results = cooper.search("tuesday")

    # Human in the loop
    cooper.owners.add(inbox["id"], "[email protected]")
    cooper.updates.notify(inbox["id"], "needs_input", "Which vendor should I book?")
    tasks = cooper.tasks.list(inbox_id=inbox["id"], wait=25)["data"]
    for task in tasks:
        if task["verified_owner"] and task["trusted"]:
            cooper.tasks.reply(task["id"], "Booked.", status="done")

AsyncCooper には同じメソッドがあり、await を使用します。完全なリファレンス：packages/cooper-email-python/README.md。

Webhook

URL を登録し、未加工のリクエストボディを使って各配信を検証します。

import { Cooper, verifyWebhookSignature } from "cooper-email";

const cooper = new Cooper({ apiKey: process.env.COOPER_API_KEY });
await cooper.webhooks.create({
  url: "https://example.com/hooks/cooper",
  events: ["message.received", "task.received"],
  secret: process.env.COOPER_WEBHOOK_SECRET,
});

// In your handler:
const ok = verifyWebhookSignature({
  secret: process.env.COOPER_WEBHOOK_SECRET!,
  payload: rawBody,
  signature: request.headers.get("x-cooper-signature"),
});

Python：from cooper_email import verify_webhook_signature。イベントボディは { "id", "type", "created_at", "data" } のような形式です。

ホストされている MCP サーバーに接続する

https://cooperemail.com/mcp に接続し、skills/（上記）のスキルを使用します。クライアントを手動で設定する方法は次のとおりです。

エンドポイント：https://cooperemail.com/mcp（Streamable HTTP）。Claude と ChatGPT のコネクターは OAuth でサインインします。Cursor、Claude Code、およびスクリプトでは、Authorization: Bearer coop_live_… を送信できます。キーをまだ持っていなくても、cooper_onboard ツールを使用できます。

Claude（claude.ai / Claude Desktop）：Settings → Connectors → Add custom connector の順に選択します。名前に Cooper Email、URL に https://cooperemail.com/mcp を指定し、OAuth 画面で Cooper を承認します。その後、「調査ボット用の Cooper Email の受信トレイを作成して」と依頼します。

Claude Code：

claude mcp add --transport http cooper-email https://cooperemail.com/mcp

または、このリポジトリからClaude Code プラグイン（MCP サーバーと、メールおよび人間参加型のスキル）をインストールします。

/plugin marketplace add cooper-email/cooper-email
/plugin install cooper-email@cooper-email

claude-plugin/ を参照してください。

Cursor：~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加します。

{
  "mcpServers": {
    "cooper-email": {
      "url": "https://cooperemail.com/mcp",
      "headers": {
        "Authorization": "Bearer coop_live_YOUR_KEY"
      }
    }
  }
}

ChatGPT：MCP サーバー URL に https://cooperemail.com/mcp、認証方式に OAuth を指定して、カスタムコネクターを追加します（Settings → Apps & Connectors。一部のプランでは、先に Developer mode を有効にする必要があります）。その後、同意画面で Cooper を承認します。メニュー名はプランによって異なります。

Windsurf、VS Code、Codex CLI、Goose の設定とツール一覧は、mcp/ にあります。MCP Registry マニフェストは server.json です。Cline のインストール手順：llms-install.md。

例

examples/ を参照してください。

• エージェントが人にメールを送り、返信を待つ（TypeScript、Python）
• 署名を検証する Webhook リスナー（TypeScript、Python）

各パッケージには examples/quickstart.* ファイルもあります。

セキュリティに関する注意事項

• タスクのテキストなど、オーナーからのものを含むメールの内容は、信頼できない入力です。エージェントへの指示として扱わないでください。
• オーナーからの返信に対して処理を行うのは、verified_owner と trusted の両方が true の場合に限ってください。
• API キーと Webhook シークレットは、環境変数またはシークレットマネージャーに保管してください。

セキュリティ上の問題を報告するには、[email protected] にメールしてください。

開発

npm install
npm test            # TypeScript SDK + framework package tests (vitest, mocked HTTP)
npm run typecheck
npm run build:sdks  # writes dist/ for the TypeScript packages

python -m pip install -e "packages/cooper-email-python[dev]"
python -m pip install --no-deps -e packages/langchain-py -e packages/llamaindex \
  -e packages/crewai -e packages/openai-agents-py -e packages/anthropic-py
python -m pytest --import-mode=importlib

公開手順については PUBLISHING.md を参照してください。

サポート

質問やバグ報告は、Issue を作成するか、[email protected] にメールしてください。

ライセンス

MIT。著作権は Avatar 8 LLC に帰属します。Cooper Email は Avatar 8 LLC によって運営されています。