Android Texter

Android Texter MCP サーバー

Claude、Cursor、Windsurf、その他の MCP クライアントから、Android Texter を通じてテキストメッセージを送受信できます。

Android Texter を使うと、お使いの Android スマートフォンを SMS と MMS のゲートウェイとして利用できます。メッセージは携帯電話会社のプランを通じて、スマートフォンの実際の電話番号から送信され、返信はアカウントに届きます。このサーバーは AI アシスタントをそのアカウントに接続するため、「Sam に会議が午後3時に変更になったとテキストで伝えて」や「昨日の一斉送信に返信したのは誰？」と言うだけで、スマートフォンから実行できます。

• 共有の短縮番号やレンタル回線ではなく、お使いの電話番号から送信します
• 会話の読み取り、メッセージ履歴の検索、連絡先の管理ができます
• テキストメッセージを後で送信するように予約したり、予約をキャンセルしたりできます
• stdio 経由でローカル実行され、API キーはお使いのコンピューターに保存されます

はじめる前に

1. Android スマートフォンにアプリをインストールし、ペアリングした Android Texter アカウント。 androidtexter.com から登録してください。
2. API キー。ダッシュボードで Settings > API Keys（androidtexter.com/dashboard/settings/api-keys）を開き、キーを作成してください。キーは atx_ で始まります。
3. Node.js 18 以降（node --version）。

インストール

このサーバーは npx で実行するため、手動でインストールする必要はありません。以下からクライアントを選び、atx_YOUR_API_KEY をお使いのキーに置き換えてください。

Claude Desktop

Settings > Developer > Edit Config を開くか、claude_desktop_config.json を直接編集し（macOS では ~/Library/Application Support/Claude/、Windows では %APPDATA%\Claude\）、次を追加してください。

{
  "mcpServers": {
    "android-texter": {
      "command": "npx",
      "args": ["-y", "android-texter-mcp"],
      "env": {
        "ATX_API_KEY": "atx_YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop を再起動してください。新しいチャットのツールメニューに Android Texter のツールが表示されます。

Claude Code

claude mcp add android-texter --scope user --env ATX_API_KEY=atx_YOUR_API_KEY -- npx -y android-texter-mcp

claude mcp list を実行して、接続されていることを確認してください。

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1つのプロジェクト）に追加してください。

{
  "mcpServers": {
    "android-texter": {
      "command": "npx",
      "args": ["-y", "android-texter-mcp"],
      "env": {
        "ATX_API_KEY": "atx_YOUR_API_KEY"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json に追加するか（または Settings > Cascade > MCP Servers > View raw config を開いてください）。

{
  "mcpServers": {
    "android-texter": {
      "command": "npx",
      "args": ["-y", "android-texter-mcp"],
      "env": {
        "ATX_API_KEY": "atx_YOUR_API_KEY"
      }
    }
  }
}

VS Code

.vscode/mcp.json に追加してください。VS Code でキーの入力を求められるのは一度だけで、キーは安全に保存されます。

{
  "inputs": [
    { "type": "promptString", "id": "atx-api-key", "description": "Android Texter API key", "password": true }
  ],
  "servers": {
    "android-texter": {
      "command": "npx",
      "args": ["-y", "android-texter-mcp"],
      "env": { "ATX_API_KEY": "${input:atx-api-key}" }
    }
  }
}

その他の MCP クライアント

環境変数に ATX_API_KEY を設定して、stdio サーバーとして npx -y android-texter-mcp を実行してください。

Windows でクライアントが npx を見つけられない場合は、"command": "cmd" と "args": ["/c", "npx", "-y", "android-texter-mcp"] を使用してください。

npm を使わない場合

同じサーバーをダッシュボードから単一ファイルとして入手できます（Settings > Integrations > Download Script）。任意の場所に保存し、上記の npx の行を "command": "node" と "args": ["/absolute/path/to/android-texter-mcp.js"] に置き換えてください。

環境変数

変数	必須	説明
ATX_API_KEY	はい	Android Texter の API キーです。Settings > API Keys から取得できます。
ATX_API_BASE	いいえ	API のルート URL です。デフォルトは https://androidtexter.com/api です。テスト用バックエンドを使う場合にのみ変更してください。
ATX_CLIENT_NAME	いいえ	API Keys のアクティビティログに表示される、この接続の名前です。ほとんどのクライアントでは自動的に検出されます。

ツール

ツール	機能
list_devices	ペアリング済みのスマートフォンを、オンライン状況、バッテリー残量、電話番号、SIMとともに一覧表示します。
list_conversations	フォルダー（すべて、受信トレイ（返信あり）、送信トレイ（返信なし）、アーカイブ、迷惑メッセージ）で絞り込んで、最近の会話を一覧表示します。
get_conversation	電話番号またはスレッドを指定して、1つの会話のメッセージを取得します（グループも対象です）。
search_messages	送受信したすべてのテキストメッセージを、単語、電話番号、または連絡先名で検索します。
send_message	選択したスマートフォンとSIMから、テキストまたは画像メッセージ（MMS）を今すぐ、または指定した日時に送信します。複数の電話番号を指定すると、グループメッセージになります。
send_broadcast	最大500件の電話番号に、それぞれ個別のメッセージとして、{{name}}形式のパーソナライズ機能を使ったテキストを一斉送信します。
get_message_status	送信したメッセージが、キューに登録済み、送信済み、配信済み、または失敗のいずれかを確認します。
list_scheduled_messages	後で送信される予定のメッセージを一覧表示します。
cancel_scheduled_message	送信前の予約済みメッセージを取り消します。
list_contacts	連絡先、またはタグが付いたすべての連絡先を一覧表示または検索します。
list_contact_tags	連絡先で使用されているすべてのタグを一覧表示します。
save_contact	電話番号を指定して連絡先を作成または更新します。指定しなかったフィールドは保持され、タグは追加されます。

送信ツールは、実在する電話番号から実在する相手にテキストメッセージを送信します。適切なクライアントでは、呼び出す前に確認を求めます。クライアントのツール設定で、常に確認を求めるように設定することもできます。

プロンプトの例

• 「オンラインになっているスマートフォンを教えてください。」
• 「返信があった直近10件の会話を表示してください。」
• 「+1 555 123 4567との会話を読んで、返信の下書きを作成してください。」
• 「+15551234567に『10分ほど遅れます。すぐ会いましょう。』とテキストを送信してください。」
• 「明日の午前9時（米国東部時間）に+15559876543へ『おはようございます！』とテキストを送信するよう予約してください。」
• 「今週、interestedという単語を含むテキストを送った人を探してください。」
• 「+15551112222をDana LeeとしてAcmeの連絡先に追加し、vipタグを付けてください。」
• 「vipタグが付いた全員に『こんにちは、{{first_name|there}}さん。早期アクセスは本日開始です。』と送信してください。」

トラブルシューティング

• 「ATX_API_KEY is not set」または「Invalid API key」：クライアント設定のキーを確認し、API Keysページで削除されていないことを確認してください。
• 「No devices registered」：まずAndroid Texterアプリでスマートフォンをペアリングしてください。
• メッセージがキューに残る：スマートフォンがオフラインであるか、アプリが実行されていません。スマートフォンでアプリを開いてください。24時間以内に送信できないメッセージは失敗としてマークされます。
• 「Daily message limit reached」：無料プランには1日あたりの上限があります。ダッシュボードのBillingからアップグレードしてください。

サポート：[email protected]。APIリファレンス：androidtexter.com/docs。

開発

npm install
npm run typecheck
npm run build            # build/index.js, the npm bin
npm run build:download   # also copies it to the dashboard download in the Android Texter monorepo

ライセンス

MIT