AI と MCP

translate と compose は、それぞれワークスペースの 1 日の枠から AI アクションを 1 回分消費し、枠を使い切ると終了コード 8 で停止します。compose と summarize は MCP ツールの composeEmail と getThreadSummary を経由するため、ブラウザでのサインインが必要です。API キーでは MCP サーバーに届きません。

openemail ai translate --to de --subject "Your invoice" --text "The invoice is attached."openemail ai translate --to Japanese --body-file reply.html --no-originalcat notes.txt | openemail ai translate --to fropenemail ai languages --search port

翻訳つき送信と同じ翻訳を実行して結果を表示するので、何かが送られる前に読めます。何も保存も送信もされません。--to にはコード、英語名、その言語自身での名前を指定できます。本文は --text、--html、--body-file、または stdin から取られ、--text と --html は @path でファイルも読めます。

• —--no-original を渡さない限り、原文は翻訳の下に残ります。
• —検出された元の言語は stderr に表示され、--json は翻訳全体を出力します。
• —送信時に翻訳するには openemail send --translate de を使います。

openemail ai compose "thank Ada for the invoice and ask for a PDF copy" --to [email protected]openemail ai compose "say yes to Tuesday at 3pm" --thread CAHk7pQ2x9LmZ4 --tone friendlyopenemail ai compose "decline politely" --thread CAHk7pQ2x9LmZ4 | openemail send --to [email protected] --subject "Re: Proposal"openemail ai summarize CAHk7pQ2x9LmZ4

• —compose はあなたの文体で書いた本文を表示し、何も送信しません。気に入ったら openemail send にパイプしてください。--thread を付けると、まずスレッドの最新メッセージを読んでから返信を書きます。--tone は formal、friendly、casual、concise、direct、warm のいずれかです。
• —summarize は件名、送信者、日付とともに要約を表示します。要約はメールの受信時に作成され、暗号化されたメッセージを含むスレッドには要約がなく、終了コード 5 になります。

OpenEmail の MCP サーバーは、アプリ内のアシスタントが使うツールを AI クライアントに提供します。承認した範囲で、メールの閲覧と送信、連絡先、テンプレート、ドメインなどの管理ができます。クライアントの接続方法は 2 つあり、openemail mcp config はお使いのクライアント向けに両方を出力します：

• —リモートサーバー。クライアントが独自にブラウザでサインインし、あなたが OpenEmail の同意ページで承認すると、アカウント → 接続済みアプリに表示されます。クライアントが対応していれば、こちらが簡単です。
• —ローカルブリッジ openemail mcp serve。クライアントが npx 経由で起動します。この CLI のサインインを使うので、先に openemail login を実行してください。ローカルサーバーしか起動できないクライアントに向いています。

openemail mcp configopenemail mcp config --client claude-codeopenemail mcp config --client cursor --profile workopenemail mcp config --client vscode --json

claude mcp add --transport http openemail https://api.openemail.uk/mcp

claude mcp add openemail -- npx -y @openemail/cli mcp serve

リモートサーバーを追加した後、Claude Code は /mcp から、Codex は codex mcp login openemail でサインインします。Claude Desktop では Settings → Connectors → Add custom connector から追加します。openemail mcp config --client <name> は、各クライアントが読むファイルも示します。

openemail mcp serve は stdin から改行区切りの JSON-RPC を読み、保存済みのブラウザでのサインインを使って各メッセージを MCP サーバーに転送し、各応答を stdout に 1 行で書き出します。期限切れのアクセストークンはクライアントに気付かれずに更新し、バッチには 1 つの配列で応答し、stdin が閉じると終了します。stdout にはプロトコルだけが出力され、--debug を渡さない限り stderr には何も出ません。

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | openemail mcp serveopenemail mcp serve --profile workopenemail mcp serve --debug 2> mcp.log

openemail mcp toolsopenemail mcp tools composeEmailopenemail mcp call whoAmIopenemail mcp call listThreads --arg folder=inbox --arg maxResults=5openemail mcp call getThread --args '{"threadId":"CAHk7pQ2x9LmZ4"}'

• —mcp tools はこのサインインで使えるツールを一覧表示します。ロールや承認で許可されていないものは最初から除かれています。ツール名を指定すると、説明と引数が表示されます。
• —mcp call は引数を --args に 1 つの JSON オブジェクトとして受け取り（インライン、@file、-）、--arg key=value は 1 つずつ設定します。値は解析できれば JSON として読まれるので、テキストのつもりの数値は引用符で囲んでください。
• —MCP サーバーは確認を求めないため、送信や削除を行うツールはすぐに実行されます。
• —Refused ( で始まる結果は終了コード 4 になります。不明なツールは 5、無効な引数は 7、AI の枠の使い切りは 8 です。

6 つのツールは REST API が確認コードで保護している変更を行うため、同じコードを求めます：createRule、setRuleEnabled、removeDomain、removeDomainAddress、自分で作成したオーディエンスに対する deleteAudience、そして自分で作成し連絡先がまだ残っているオーディエンスに対する emptyAudience です。ターミナルでは、mcp call がコードを尋ねてからツールを再度呼び出します。無人実行では終了コード 4 になるので、先に openemail verify を実行してください。

openemail docs ask "how do I verify a domain?"openemail docs open cli/authenticationopenemail docs read cli/commandsopenemail docs read

• —docs ask はドキュメントアシスタントに質問し、回答を書かれるそばから表示した後、出典のページを表示します。このドキュメントだけを根拠に回答し、サインインは不要で、認証情報を送ることはありません。質問は最大 600 文字で、ネットワークごとに 1 日の質問数に上限があります。
• —docs open はブラウザでページを開き、--print は代わりにそのリンクを表示します。
• —docs read はページを Markdown で表示します。ページを指定しなければ、全ページの目次を表示します。