NAVER MYBOX

naver-mybox-mcp

NAVER MYBOX（네이버 마이박스）用の MCP サーバーです。あらゆる MCP クライアント（Claude Code、Claude Desktop など）から、MYBOX のクラウドドライブ内のファイルを一覧表示、検索、ダウンロード、アップロードできます。

MYBOX は 2026 年 8 月に公開 API を開始しました（developers.mybox.naver.com）。 このサーバーは、その API をツールとして利用できるようにします。非公式であり、NAVER とは無関係です。

理由

スマートフォンの写真は自動的に MYBOX に保存されます。それをパソコンに移すには、ウェブ UI を何度もクリックする必要がありました。このサーバーを使えば、エージェントが「9 月 10 日〜11 日に撮影したすべての写真」を作業フォルダーに一度で取得できます。

インストール

Python 3.10 以降が必要です。

pip install naver-mybox-mcp

トークンを取得する

認証には OAuth ではなく、個人用アクセストークンを使用します。

1. ウェブで MYBOX にサインインします。
2. 「設定」→ アカウントと個人用アクセストークンの管理 → トークンを作成を選択します。
3. トークンは一度しか表示されないため、すぐにコピーします。

1 アカウントにつき最大 5 個のトークンを作成できます。各トークンの有効期間は 30 日、60 日、90 日、または 180 日です。有効期限の 7 日前と 1 日前に MYBOX からメールが届きます。トークンを持つ人はドライブ全体にアクセスできるため、パスワードと同様に扱い、絶対にコミットしないでください。

MYBOX_PAT 環境変数で指定するか、~/.mybox/token の 1 行目に記述してください。

MCP クライアントを設定する

{
  "mcpServers": {
    "mybox": {
      "command": "naver-mybox-mcp",
      "env": { "MYBOX_PAT": "mbx_pat_..." }
    }
  }
}

Claude Code の場合：claude mcp add mybox --env MYBOX_PAT=mbx_pat_... -- naver-mybox-mcp

ツール

ツール	機能
mybox_storage	クォータ、使用済みバイト数、カテゴリ別ファイル数、最大アップロードサイズ
mybox_list	フォルダーまたはドライブルート直下の項目
mybox_search	キーワード、カテゴリ、日付範囲（KST）による検索
mybox_file_info	ファイルまたはフォルダーの属性
mybox_download	ファイルをローカルディレクトリにダウンロード
mybox_upload	ローカルファイルを 1 つアップロード
mybox_create_folder	フォルダーを作成

意図的に未対応：削除

API では、ファイルの削除、ゴミ箱を空にする操作、自動削除期間の設定が可能です。しかし、ここではそれらのツールを公開していません。ファイルを読み書きできるエージェントは便利ですが、ファイルを消去できるエージェントには別のリスクがあり、ウェブ UI もすぐに利用できます。フラグによる有効化を希望する場合は、issue を作成してください。

クォータ

ドキュメントにはプランごとの制限が公開されており、短時間の大量利用や不正利用は事前の通知なくブロックされる可能性があると記載されています。そのため、クライアントは、ドキュメントに記載された最も低い 1 分あたりの制限（検索は 9 回、それ以外は 55 回）を下回るようにリクエスト間隔を調整します。無料アカウントでも API を利用できます。プランによって変わるのは制限のみです。

プラン	ダウンロード	検索	その他の API
30GB	500 回/日	10 回/分	各 60 回/分
80GB	1,000 回/日	10 回/分	各 60 回/分
180GB–330GB	1,000 回/日	30 回/分	各 240 回/分
2TB	2,000 回/日	30 回/分	各 240 回/分

ダウンロード制限は 1 日単位であり、クライアント側でリクエスト間隔を調整しても回避できません。 まず検索して結果数を確認し、件数が多い場合は複数回に分けて取得してください。

API に関する注意事項

• ベース URL は https://open-api.mybox.naver.com/v1 です。
• アップロードは 2 段階です。POST /drive/files が uploadUrl（有効期間 48 時間、1 回限り）を返し、ファイルのバイトデータは Filedata というマルチパートフィールドでその URL に送信します。
• ダウンロードは 2 段階です。GET /drive/files/{id}/download が downloadUrl（有効期間 10 分、1 回限り）を返します。
• ページングでは、responseMetaData.nextCursor を cursor として渡します。
• 検索には、キーワード、カテゴリ、日付の下限のいずれかが必要です。
• 暗号化されたフォルダーと、あなたと共有されたフォルダーは API から参照できません。ウェブアプリとモバイルアプリでのみ利用できます。一覧が空でも、ドライブが空とは限りません。

関連プロジェクト

MYBOX API は 2026-08-10 に公開され、ツールもすぐに登場しました。NAVER は独自の MCP サーバーや SDK を公開しておらず、ローンチ投稿でも MCP について言及していません。存在するコミュニティの取り組みは次のとおりです。

プロジェクト	内容
minking/mybox-mcp	削除とゴミ箱を含む 20 個すべてのエンドポイントに対応する TypeScript 製 MCP サーバー
oliverne/myboxctl	ファイル操作用 CLI（npm では @oliverne/myboxctl）
overworks/php-mybox	PHP SDK、および同じ作者による Go CLI と Flysystem アダプター
chiwanpark/mybox-s3	MYBOX の前段にある S3 互換 API

このプロジェクトは Python 製で、意図的に機能を絞って公開しています（削除機能はありません）。文書化されたレート制限に従ってリクエスト間隔を調整し、トークンもネットワークも不要なテストを同梱しています。用途に合うものを選んでください。破壊的な操作を含むすべてのエンドポイントが必要な場合は、上記の TypeScript サーバーに対応機能があります。

開発

pip install -e ".[dev]"
pytest

テストは httpx.MockTransport を使用して実行するため、トークンもネットワークも不要です。

GitHub リリース時に GitHub Actions からリリースを公開します。PyPI には Trusted Publishing（保存済みトークン不要）を、MCP レジストリには GitHub OIDC を使用します。

ライセンス

MIT