doubletick-cli

DoubleTick CLI

Gmail を使ったメール開封追跡のためのオープンソース CLI および MCP サーバーです。ターミナルから、メールが開封されたかどうかを確認できます。

DoubleTick バックエンドと連携します。CLI からの追跡情報は、Chrome 拡張機能からの追跡情報と一緒に表示されます。

インストール

npm install -g doubletick-cli

クイックスタート

# 1. Log in with your Gmail account (one-time)
doubletick login

# 2. Send a tracked email
doubletick send --to [email protected] --subject "Q1 Planning" --body "Hi Jane, here are the numbers..."

# 3. Check if they read it
doubletick status --last

コマンド

doubletick login

Gmail と DoubleTick で認証します。Google サインインのためにブラウザーを開きます。初回のみ必要な設定で、認証情報はローカルの ~/.doubletick/credentials.json に保存されます。

doubletick logout

保存された認証情報を削除します。

doubletick send

追跡対象のメールを送信します。開封追跡ピクセルを挿入し、Gmail API 経由で送信して、追跡情報を登録します。

# Send a tracked email (body is markdown by default)
doubletick send --to [email protected] --subject "Hi" --body "Hello **Jane**"

# HTML body instead of markdown
doubletick send --to [email protected] --subject "Hi" --body "<h1>Hello</h1>" --html

# Body from file
doubletick send --to [email protected] --subject "Hi" --body-file ./email.md

# With CC/BCC
doubletick send --to [email protected] --cc "[email protected]" --subject "Hi" --body "Hello"

doubletick status

追跡対象のメールが開封されたかどうかを確認します。

# Most recent tracked email
doubletick status --last

# Find by recipient
doubletick status --to [email protected]

# By tracking ID
doubletick status abc-123

doubletick dashboard

開封率と統計情報を含む、追跡対象のメールをすべて一覧表示します。

doubletick dashboard
doubletick dashboard --limit 50

MCP サーバー

DoubleTick は MCP サーバーとして動作するため、AI エージェント（Claude Code、Claude Desktop など）からメールをネイティブに送信し、追跡できます。

セットアップ

Claude の設定に追加します。

{
  "mcpServers": {
    "doubletick": {
      "command": "npx",
      "args": ["-y", "doubletick-cli"]
    }
  }
}

最初に doubletick login を実行する必要があります。MCP サーバーは同じ保存済み認証情報を使用します。

ツール

ツール	説明
send_tracked_email	開封追跡付きのメールを送信します
check_tracking_status	追跡対象のメールが開封されたかどうかを確認します
list_tracked_emails	最近の追跡対象メールと統計情報を一覧表示します

仕組み

1. メールを作成します（テキストまたは Markdown）。
2. CLI が HTML に変換し、追跡 ID を生成して、1x1 の追跡ピクセルを挿入します。
3. Gmail API 経由でメールを送信します。
4. DoubleTick のバックエンドに追跡情報を登録します。
5. 受信者がメールを開くとピクセルが読み込まれ、開封が記録されます。
6. doubletick status でステータスを確認します。

DoubleTick のバックエンド全体（ピクセル配信、開封記録、重複排除、デバイス検出）は変更せずに動作します。CLI はピクセルを挿入する新しい手段にすぎず、ターミナルやエージェントのワークフローでは Chrome 拡張機能の役割を置き換えます。

アーキテクチャ

doubletick CLI / MCP server
  ├── Gmail API        → send emails
  └── DoubleTick API   → register tracks, check status
        ├── GET  /img?t=<id>   → tracking pixel
        ├── POST /track        → register tracked email
        ├── GET  /status?id=   → check opens
        └── GET  /dashboard    → list tracked emails

必要条件

• Node.js 18+
• Gmail アカウント
• DoubleTick アカウント（無料プラン：週 5 通まで追跡可能）

ライセンス

MIT