listonic-mcp

listonic-mcp

AI エージェント（Claude、Cursor、または任意の MCP クライアント）が実際の Listonic の買い物リストを操作できるようにする、MCP（Model Context Protocol）サーバーです。読み取り、項目の追加、購入済みへのチェックを行え、Listonic が同期するすべてのデバイスで利用できます。

分かりやすい活用例は、買い物リストにつながる献立の計画です。エージェントに今週の夕食を計画するよう頼むと、足りない食材が数量も含めてスマートフォンのリストに直接追加されます。あるいは、レシピを貼り付けて「持っていないものを追加して」と伝えると、サーバーがチェック済み（すでに家にあるもの）と未チェックの項目をエージェントに知らせます。

You:   plan me 3 cheap high-protein dinners and put the ingredients on my list
Agent: [reads your list — sees you already have rice, eggs, frozen spinach]
       [adds: 1 kg chicken thighs, 400 g lentils, greek yogurt ×2, ...]

非公式です。 Listonic とは提携していません。ウェブアプリの API（リバースエンジニアリング済み。詳細は API.md に記載）を利用しています。Listonic が API を変更すると、動作しなくなる可能性があります。

インストール

Python 3.10 以降と Listonic アカウント（無料）が必要です。

pip install listonic-mcp

エージェントに追加する

command に listonic-mcp を指定し、Listonic のログイン情報を渡します。

{
  "mcpServers": {
    "listonic": {
      "command": "listonic-mcp",
      "env": {
        "LISTONIC_EMAIL": "[email protected]",
        "LISTONIC_PASSWORD": "your-listonic-password"
      }
    }
  }
}

同じ値は --email / --password 引数として渡すこともできます。クライアントで使いやすい方法を選んでください。

claude mcp add listonic -e [email protected] -e LISTONIC_PASSWORD=your-password -- listonic-mcp

あとは、次のように尋ねるだけです。

What's on my grocery list? Check off the milk, I just bought it.

起動パラメーター

ツール

各ツールでは list_id を省略できます。複数のリスト（「週末の BBQ」「薬局」など）も簡単に使えます。

知っておくと便利なこと

• パスワードは Listonic にのみ送信されます。 サーバーは api.listonic.com に直接ログインし、それ以外とは通信しません。テレメトリーはなく、有効期限が切れると自動更新されるメモリー内のセッショントークン以外は保存されません。
• ソース内のクライアント ID／シークレットは、Listonic のウェブアプリ独自の認証情報です。公開 JavaScript バンドルに含まれており、すべてのウェブユーザーで共有されるもので、個人の秘密情報ではありません。
• リスト、項目、カテゴリー、アカウントのエンドポイントを含む、リバースエンジニアリングした API の全容は API.md に記載されています。サーバーを拡張する場合に役立ちます。

自分用にカスタマイズ

フレームワークの複雑な仕組みを使わない、読みやすい単一ファイルです。フォークして自由に編集できます。価格の追跡、カテゴリーの並べ替え、レシピ解析などを追加できます。ソースから実行するには、次のとおりです。

git clone https://github.com/ArturLys/listonic-mcp.git
cd listonic-mcp
pip install -e .
listonic-mcp --email [email protected] --password your-password

クレジット

• Listonic — このアプリが連携する買い物リストアプリです。愛用しているなら、プレミアムの利用料金を支払いましょう。

ライセンス

MIT