Amazon Orders

amazon-orders-mcp は、amazon-orders を基盤とする、Amazon の注文履歴、注文明細、 および取引履歴向けの非公式な MCP サーバーです。AI アシスタントに Amazon アカウント用の ツールを提供し、Claude やその他の MCP クライアントから利用できます。

このサーバーが認証情報を取得することはありません。サインインすると、Amazon の公式ページがブラウザーウィンドウで開き、サーバーは その後に残るセッションを再利用します。また、ディスプレイのないサーバーでも実行でき、その場合は代わりにターミナルからサインインします （リモートクライアントを参照）。

注： このサーバーは amazon-orders を通じてデータを読み取ります。amazon-orders は Amazon の 一般消費者向けウェブサイトのデータを解析して動作します。Amazon が利用可能な公式 API を提供していないため、古いバージョンはいつでも動作しなくなる可能性があります。 そのため、最新バージョンを使用することをおすすめします。

インストール

amazon-orders-mcp は PyPI で入手でき、uvx を使って 実行するため、事前にインストールする必要はありません。AI アシスタントに追加してください。

Claude

Claude Desktop： 最新リリースから amazon-orders-mcp-<version>.mcpb をダウンロードして開きます。

Claude Code：

claude mcp add amazon-orders -- uvx amazon-orders-mcp

ChatGPT

ChatGPT Desktop： 設定 → プラグインで、タイプが STDIO の MCP サーバーを追加し、コマンドに uvx、引数に amazon-orders-mcp を指定します。

Codex：

codex mcp add amazon-orders -- uvx amazon-orders-mcp

その他のクライアント

ローカル MCP サーバーを実行するクライアントであれば、この JSON を使用できます。pip install amazon-orders-mcp でインストール済みの場合は、 コマンドとして amazon-orders-mcp を指定することもできます。

{
  "mcpServers": {
    "amazon-orders": {
      "command": "uvx",
      "args": ["amazon-orders-mcp"]
    }
  }
}

リモートクライアント

サーバーを実行するのではなくサーバーに接続するクライアント向けに、サーバーは Streamable HTTP でもサービスを提供できます。

uvx amazon-orders-mcp --transport streamable-http

http://127.0.0.1:8000/mcp でリッスンします。変更する場合や、ベアラートークンを必須にする場合（ループバック以外では必須）は --help を参照してください。 ディスプレイのないサーバーでは sign_in がブラウザーウィンドウを開けないため、先に uvx amazon-orders login を実行してサインインしてください。 このコマンドでは代わりにユーザー名とパスワードの入力を求められます。

Docker

docker build -t amazon-orders-mcp .
docker run -i --rm -v amazon-orders:/home/app/.config/amazonorders amazon-orders-mcp

コンテナーにはディスプレイがないため、最初に login ターゲットでサインインしてください。方法については Dockerfile を参照してください。

基本的な使い方

注文についてアシスタントに尋ねるだけで、以下のツールを使用します。

ツール	返される内容
sign_in	求められたときに、Amazon にサインインするためのブラウザーウィンドウを開きます
get_orders	年、期間フィルター、または注文タイプで絞り込んだ注文の一覧。詳細情報も取得できます
search_orders	年を問わず、商品、注文番号、住所、または受取人で絞り込んだ商品の一覧
get_order	注文番号で指定した1件の注文
get_tracking	注文の配送 ID から取得した配送業者と追跡番号
get_invoices	注文の印刷可能な概要と、販売者が発行した請求書 PDF
get_family_members	Teen アカウントなど、注文を閲覧できる Amazon Household のメンバー
get_transactions	指定日数分、または指定注文の決済取引の一覧
get_gift_cards	ギフトカードの残高と、指定日数分の利用履歴
get_prime_payments	Prime 会費の請求と、それぞれの注文番号
check_session	セッションがある各 Amazon サイトで、サインイン済みかどうか
get_config	アシスタントが変更できる設定と、その値
update_config	いずれかの設定を変更します

注文履歴と取引は、limit 件ずつ（デフォルトは25件で、1ページ分を超える件数も指定できます）のバッチで返されます。次のバッチを取得するには、アシスタントが cursor を渡します。

Amazon からデータを読み取る各ツールでは、amazon.de のように site を任意で指定できます。これにより、1つのサーバーから利用している各 Amazon サイトのデータを読み取れます。たとえば、「amazon.de の直近の注文」と尋ねられます。指定しない場合、ツールはデフォルトのサイトである domain 設定のサイトから読み取ります。サイトごとにサインインが必要なため、それぞれのサイトにサインインするようアシスタントに依頼してください。

設定

デフォルトの Amazon サイト（例：amazon.co.uk）や、サインインに使用するブラウザーなどの設定変更をアシスタントに依頼してください。設定は amazon-orders CLI と共有されるため、同じ変更が反映されます。amazon-orders が読み取れるサイトについては、サポートされているサイトをご覧ください。

ドキュメント

サーバーが返すデータについて詳しくは、amazon-orders の公式ドキュメントをRead the Docsでご覧いただけます。Order エンティティのフィールドやトラブルシューティングも掲載されています。

貢献

金銭的な支援をご希望ですか？amazon-orders-mcp が役に立ったと感じた場合は、スポンサーとしてのご支援をいただけると大変ありがたいです！