Lettr Transactional Email Api Mcp

Lettr MCP サーバー

重要

このパッケージは更新を終了しました。代わりに、Lettr のホスト型 MCP サーバーをご利用ください： https://app.lettr.com/mcp

ホスト型サーバーは Lettr API とともに保守されているため、新しいツールや修正はそちらに追加され、このパッケージには追加されません。このパッケージは引き続き動作しますが、今後新機能が追加されることはありません。

サインインに使用する Lettr アカウントで切り替える場合（OAuth）：

claude mcp add --transport http lettr https://app.lettr.com/mcp

その後、クライアントに求められたら認証します。管理が必要な API キーはありません。

API キーを使って切り替える場合（CI、cron ジョブ、ブラウザーを使えないその他の環境向け）：

claude mcp add --transport http lettr https://app.lettr.com/mcp \
  --header "Authorization: Bearer lttr_xxxxxxxxx"

Cursor、Claude Desktop、その他のクライアントについては、API キーで接続するとリモートサーバーのセットアップガイドをご覧ください。

移行前に知っておきたい違いがいくつかあります。ツール名は snake_case 形式（send-email ではなく send_email）で、一部のパラメーター名も異なります（contactId ではなく contact_id）。また、ホスト型サーバーにはこのパッケージにはなかった分析、メールイベント、API ログ用のツールがあります。

Lettr の公式 Model Context Protocol（MCP）サーバーです。Lettr は開発者向けのメール API です。Claude Desktop、Cursor、Claude Code などの MCP クライアントから、トランザクションメールの送信、マージタグを使ったテンプレートの管理、ドメインの設定、Webhook の監視を直接行えます。

Lettr を選ぶ理由

Lettr は、開発者向けに構築された最新のメール送信プラットフォームです。シンプルな REST API、強力なドラッグ＆ドロップ式テンプレートエディター、マージタグによるパーソナライズ、開封・クリックの追跡、そして業界最高水準の到達率を提供します。パスワードリセット、注文確認、オンボーディングの一連のメールなどを、簡単かつ確実に送信できます。

• API リファレンス — REST API の全ドキュメント
• テンプレート — マージタグに対応したビジュアルメールエディター
• ドメイン — ドメインの検証と DNS の設定
• Webhook — リアルタイムのイベント通知
• クイックスタートガイド — Node.js、PHP、Laravel、Python、Go、Rust など

機能

• メールの送信 — トランザクションメールを、HTML、プレーンテキスト、CC/BCC、添付ファイル、トラッキングオプション、メタデータ、タグ付きで送信します。差し込みタグの置換を使ったテンプレートベースの送信、配信日時の予約、送信済みメッセージやイベントの確認に対応しています。
• テンプレート — トランザクションメールまたはキャンペーンメールのテンプレートを一覧表示、作成、取得、更新、削除します。レンダリング済みのHTMLと差し込みタグを取得し、送信前にテンプレートが想定する変数を確認できます。
• ドメイン — 送信ドメインを一覧表示、作成、取得、削除、確認します。SPF、DKIM、DMARC 認証に必要な DNS レコードを表示します。
• Webhook — リアルタイムのメールイベント通知用のWebhook 設定を一覧表示、作成、取得、更新、削除します。
• プロジェクト — チームで利用できるプロジェクトを一覧表示し、テンプレートおよびメールのツールで特定のプロジェクトを対象にできます。
• オーディエンス — 連絡先、リスト、サブスクリプションのトピック、カスタムプロパティ、セグメントを管理します。連絡先の作成と更新（二重オプトイン対応）、連絡先のリストやトピックへの追加、一括インポート、一致条件に基づくセグメントの作成ができます。
• システム — クライアントのセットアップと診断用のヘルスチェックおよび API キーの検証を行います。

セットアップ

1. 無料のLettr アカウントを作成します
2. ダッシュボードでAPI キーを作成します
3. 任意の宛先にメールを送信するには、ドメインを確認します

使用方法

Claude Code

claude mcp add lettr -e LETTR_API_KEY=lttr_xxxxxxxxx -- npx -y lettr-mcp

Cursor

コマンドパレットを開き、「Cursor Settings」>「MCP」>「Add new global MCP server」を選択します。

{
  "mcpServers": {
    "lettr": {
      "command": "npx",
      "args": ["-y", "lettr-mcp"],
      "env": {
        "LETTR_API_KEY": "lttr_xxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Claude Desktop の設定を開き、「Developer」タブで「Edit Config」を選択します。

{
  "mcpServers": {
    "lettr": {
      "command": "npx",
      "args": ["-y", "lettr-mcp"],
      "env": {
        "LETTR_API_KEY": "lttr_xxxxxxxxx"
      }
    }
  }
}

オプション

サーバーを設定するために、追加の引数を渡すことができます。

• --key: Lettr API キー（LETTR_API_KEY 環境変数の代わり）
• --sender: 確認済みドメインのデフォルト送信者メールアドレス
• --reply-to: デフォルトの返信先メールアドレス

環境変数：

• LETTR_API_KEY: Lettr API キー（必須）
• SENDER_EMAIL_ADDRESS: 確認済みドメインのデフォルト送信者メールアドレス（任意）
• REPLY_TO_EMAIL_ADDRESS: デフォルトの返信先メールアドレス（任意）

注： 送信者メールアドレスを指定しない場合、MCP サーバーはメールを送信するたびにアドレスを尋ねます。

利用可能なツール

メール

ツール	説明
send-email	HTML、プレーンテキスト、テンプレート、添付ファイル、トラッキング、パーソナライズに対応したトランザクションメールを送信します
list-emails	最近送信したメールを一覧表示します（カーソルページネーション対応、宛先と日付でフィルタリング可能）
list-email-events	メールイベント（配信、バウンス、クリック、開封、…）を一覧表示し、種類、宛先、送信、日付範囲でフィルタリングします
get-email-detail	リクエスト ID を指定して、単一の送信に関する配信タイムライン全体を取得します
schedule-email	トランザクションメールの将来の配信を予約します（5 分以上先、30 日以内）
list-scheduled-emails	送信待ちのメールを状態でフィルタリングして一覧表示します
get-scheduled-email	予約済みメールの状態とイベントを取得します
cancel-scheduled-email	送信前の予約済みメールをキャンセルします

テンプレート

ツール	説明
list-templates	メールテンプレートを一覧表示します。目的やフォルダーで絞り込めます
get-template	HTML コンテンツを含む、テンプレートの詳細を取得します
create-template	HTML またはビジュアルエディターの JSON を使用して、トランザクション用またはキャンペーン用の新しいテンプレートを作成します
update-template	テンプレート名やコンテンツを更新します（新しいバージョンが作成されます）
delete-template	テンプレートとすべてのバージョンを完全に削除します
get-merge-tags	テンプレートが想定するマージタグ変数を確認します
get-template-html	プロジェクト ID とスラッグを指定して、テンプレートのレンダリング済み HTML、件名、マージタグを取得します

テンプレートの目的。 テンプレートは transactional（デフォルト。領収書、パスワードリセット、アラートなど）または campaign（オーディエンスリストに送信するマーケティングメール）のいずれかです。キャンペーンでは目的が campaign のテンプレートのみ送信でき、作成後に目的を変更することはできません。そのため、デフォルトの目的で作成したニュースレターは作り直す必要があります。1 人ではなくオーディエンスにメッセージを送信する場合は、create-template に purpose を指定してください。

準備状況。 インポートしたテンプレートは非同期でレンダリングされるため、送信可能になる前にテンプレートが存在する場合があります。list-templates と get-template は pending、ready、failed のいずれかを報告します。更新後、新しいレンダリングが完了するまでは以前のレンダリングが引き続き提供されるため、準備中のテンプレートでも送信できます。ただし、新しいコンテンツはまだ反映されていません。

フォルダー

ツール	説明
list-folders	テンプレートが分類されているフォルダーを、目的とテンプレート数とともに一覧表示します

folder_id を確認するには、フォルダーを見つけることが唯一の方法です。このツールを使わない場合、folder_id を省略して API が選ぶフォルダーを受け入れるか、アプリの URL に表示される整数を推測することになります。フォルダーの目的は、その中にあるテンプレートの目的とは独立しています。テンプレートをキャンペーン用フォルダーに分類しても、そのテンプレートがキャンペーン用になるわけではありません。

ドメイン

ツール	説明
list-domains	すべての送信ドメインと検証状況を一覧表示します
create-domain	新しい送信ドメインを登録します
get-domain	DNS レコードを含むドメインの詳細を取得します
delete-domain	送信ドメインを削除します
verify-domain	ドメインの DNS 検証を開始します

Webhook

ツール	説明
list-webhooks	すべての Webhook 設定を一覧表示します
get-webhook	Webhook の詳細と配信状況を取得します
create-webhook	認証とイベントタイプを選択して、新しい Webhook サブスクリプションを作成します
update-webhook	既存の Webhook を更新します（名前、URL、認証、イベント、有効フラグ）
delete-webhook	Webhook サブスクリプションを削除します

プロジェクト

ツール	説明
list-projects	チームが所有するプロジェクトを一覧表示します。プロジェクト ID の確認に便利です

オーディエンス

ツール	説明
list-audience-lists	ページネーションを使用してオーディエンス（連絡先）リストを一覧表示
create-audience-list	新しいオーディエンスリストを作成
get-audience-list	単一のリストと連絡先数を取得
update-audience-list	オーディエンスリストの名前を変更
delete-audience-list	オーディエンスリストを削除
bulk-delete-audience-lists	1 回の呼び出しで最大 50 件のリストを削除
list-audience-contacts	検索、ステータス、リスト、セグメントのフィルターを使用して連絡先を一覧表示
get-audience-contact	プロパティ、リスト、トピックを含む連絡先を取得
create-audience-contact	ダブルオプトインを任意で設定して連絡先を作成
bulk-create-audience-contacts	メールアドレスのフラットリスト、または連絡先ごとに 1 行の形式で複数の連絡先を作成
update-audience-contact	連絡先のメールアドレス、ステータス、またはプロパティを更新
delete-audience-contact	連絡先を削除
attach-contact-to-list	連絡先をリストに追加
detach-contact-from-list	連絡先をリストから削除
subscribe-contact-to-topic	連絡先をトピックに登録
unsubscribe-contact-from-topic	連絡先のトピック登録を解除
bulk-attach-contacts-to-lists	複数の連絡先を複数のリストに一度に追加
bulk-detach-contacts-from-lists	複数の連絡先を複数のリストから一度に削除
bulk-subscribe-contacts-to-topics	複数の連絡先を複数のトピックに一度に登録
bulk-unsubscribe-contacts-from-topics	複数の連絡先の複数のトピック登録を一度に解除
list-audience-topics	ページネーションを使用してサブスクリプショントピックを一覧表示
create-audience-topic	サブスクリプショントピックを作成
get-audience-topic	単一のトピックを取得
update-audience-topic	トピックの名前、説明、または公開設定を更新
delete-audience-topic	サブスクリプショントピックを削除
list-audience-properties	カスタム連絡先プロパティを一覧表示
create-audience-property	新しいカスタムプロパティを定義
get-audience-property	単一のプロパティを取得
update-audience-property	プロパティのフォールバック値を更新
delete-audience-property	カスタムプロパティを削除
list-audience-segments	リストで絞り込んでセグメントを一覧表示
create-audience-segment	条件に基づいてセグメントを作成
get-audience-segment	単一のセグメントとその条件を取得
update-audience-segment	セグメントの名前、リスト、または条件を更新
delete-audience-segment	セグメントを削除

システム

ツール	説明
health-check	Lettr API のヘルスステータスを確認
auth-check	設定された API キーを検証し、チーム ID を返す

ローカル開発

1. クローンしてビルドします。

git clone https://github.com/nicholasgriffintn/lettr-mcp.git
cd lettr-mcp
pnpm install
pnpm run build

2. MCP クライアントでローカルビルドを使用します。

{
  "mcpServers": {
    "lettr": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
      "env": {
        "LETTR_API_KEY": "lttr_xxxxxxxxx"
      }
    }
  }
}

MCP Inspector でのテスト

まずプロジェクトをビルドしてください（上記のローカル開発を参照）。

1. API キーを設定します。

   export LETTR_API_KEY=lttr_your_key_here
   

2. Inspector を起動します。

   pnpm inspector
   

3. ブラウザー（Inspector UI）で次の操作を行います。

   • stdio（プロセスを起動）を選択します。
   • Command： node
   • Args： dist/index.js
   • Env： LETTR_API_KEY=lttr_your_key_here
   • Connect をクリックし、「List tools」を使用してサーバーが動作していることを確認します。

リソース

• Lettr のウェブサイト
• API ドキュメント
• MCP セットアップガイド
• MCP ツールリファレンス
• テンプレート言語
• DNS セットアップガイド
• ナレッジベース

ライセンス

MIT