convez.ai
MCP ServerAutomaçãoIntermediário
whimCrouwel

WOV Mailer

whimCrouwel/wov-mailer

Envio em massa de emails do Airtable via Resend com MCP + Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

App de desktop macOS que realiza envio em massa de emails integrando Airtable com Resend. Oferece templates HTML, filtros avançados, variáveis de personalização, preview, histórico de envios e integração MCP com Claude Code para automação de campanha via IA.

Instalação

$npx convez-ai whimCrouwel/wov-mailer

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
1
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Campanhas de marketing com personalização por campo do Airtable
  • Notificações e emails transacionais em massa
  • Gerenciamento de contatos com filtros complexos (equals, not_equals, contains, gt, lt)
  • Automação de envios via Claude Code MCP

Veredito

Ferramenta especializada em automação de email marketing com foco em integração Airtable + Resend. A integração MCP com Claude Code agrega valor significativo para workflows programáticos, mas o escopo é específico (email em massa) e limitado a macOS. Beta stage ainda requer validação de estabilidade.

README

A tradução para o português deste README ainda está na fila.

wov-mailer

Airtable の連絡先リストから、Resend 経由でメール一斉送信を行う macOS デスクトップアプリです。


機能

  • Airtable 連携 — ベース・テーブルを選択し、フィルターで送信対象を絞り込む
  • 差し込み変数 — {{fieldName}} 形式でAirtableのフィールド値をメール本文に埋め込める。エディタ内で @ を入力するとフィールド候補が表示される
  • メールテンプレート — 5種類のHTMLテンプレートを内蔵。Gmail / Outlook / Apple Mail など主要クライアントで表示確認済み
  • マーケティング / トランザクション切替 — ブロードキャストごとに送信タイプを切り替えられる。マーケティングON: 配信停止リンクを含み、Resend の配信停止フィルターを適用。マーケティングOFF: リンクなしのトランザクション送信(通知・領収書など)
  • プレビュー — 送信前にAirtableの1行目のデータで差し込み結果をプレビューできる
  • 送信先リスト確認 — 送信前に名前とメールアドレスの一覧をダイアログで確認できる
  • 送信履歴 — 過去のブロードキャスト履歴を管理。当時の送信先スナップショットを保存するため、Airtable のデータが変わっても受信者リストを確認できる
  • 下書き保存 — 作成中のブロードキャストを下書きとして保存・再編集・削除できる。MCP からも操作可能
  • 内蔵ターミナル — Claude Code MCP と連携したターミナルをアプリ内に内蔵。パネルを閉じても pty セッションは維持される

必要環境

  • macOS (arm64 / x64)
  • Node.js v18 以上
  • Airtable アカウントと Personal Access Token
  • Resend アカウントと API キー(送信ドメインの認証が必要)

セットアップ

1. リポジトリのクローン

git clone https://github.com/YOUR_USERNAME/wov-mailer.git
cd wov-mailer

2. 依存パッケージのインストール

npm install

postinstall スクリプトにより、node-pty が Electron 用に自動リビルドされます。

3. 開発サーバーの起動

npm run dev

4. 初回設定

アプリ起動後、Settings 画面で以下を設定してください。

項目説明
Airtable TokenAirtable の Personal Access Token
Resend API KeyResend の API キー
Sender Name送信者名(例: Whim on Vim)
Sender Email送信元メールアドレス(Resend で認証済みのドメイン)

設定は ~/.config/wov-mailer/config.json に保存されます(リポジトリには含まれません)。


ビルド(macOS アプリとして配布)

npm run dist

dist/ フォルダに wov-mailer-0.1.0-arm64.dmg が生成されます。


テンプレート

templates/ フォルダにHTMLテンプレートを追加することで、カスタムテンプレートを利用できます。
初回起動時に ~/.config/wov-mailer/templates/ へコピーされます。

テンプレート名説明
minimalシンプルな白カード(デフォルト)
newsletterダークテーマ、パープルアクセント
promoプロモーション向け、グラデーションヒーロー
announcementお知らせ向け、グリーンアクセント
default基本テンプレート

MCP 連携(Claude Code)

内蔵ターミナルは Claude Code の MCP サーバー(ポート 3741)と連携できます。
各ツールには説明文が付いており、Claude が文脈に応じて自動的に適切なツールを選択します。

リソース

リソース説明
wov-mailer://contextベース・テーブル・テンプレートの全情報を1回で取得。会話開始時に読み込むことで、Claude が選択肢を把握した上でインタラクティブに質問できる

複合ツール(推奨)

ツール説明
setup_recipients(baseId, tableId, filters?)ベース・テーブル・フィルターを1回のコールで設定。送信先件数とサンプルを返す。operator: equals / not_equals / contains / gt / lt
setup_content(templateName, subject, body)テンプレート・件名・本文を1回のコールで設定。setup_recipients と並行実行可能

個別ツール

ツール説明
list_basesAirtable のベース一覧を取得
select_baseベースを選択
list_tables選択中のベースのテーブル一覧を取得(メールフィールドがあるもののみ)
select_tableテーブルを選択
add_filter送信対象を絞り込むフィルターを追加(operator: equals / not_equals / contains / gt / lt)
clear_filtersフィルターをすべてクリア
preview_recipients現在の設定での送信先件数とサンプルを確認
set_subject件名を設定
set_body本文(Markdown)を設定。{{fieldName}} で差し込み変数を使用可能
list_templatesテンプレート一覧を取得
select_templateテンプレートを選択
set_marketingマーケティングモードの ON/OFF を切り替え
list_drafts保存済み下書き一覧を表示
save_draft現在の状態を下書きとして保存(同一下書きは上書き)
load_draft下書きを復元
delete_draft下書きを削除

初回のみ以下のコマンドで登録してください。

claude mcp add wov-mailer --transport http http://127.0.0.1:3741 --scope user

以降はアプリを起動するだけで自動接続されます。

wov-mailer-compose スキル

wov-mailer-compose Claude スキルを使うと、コンポーズ画面を対話式に素早く埋められます。

  1. wov-mailer://context リソースを読み込み、選択肢を把握
  2. ベース・テーブル・件名・本文・テンプレートをインタラクティブに質問
  3. setup_recipients と setup_content を並行実行してコンポーズ画面を一括設定

使い方: 「メールを作って」「compose an email」と話しかけるだけ。


ライセンス

MIT


作者

Whim on Vim

Ver o original no GitHub

Bom para

Relacionados