MCP server: One MCP server.

NAVER MYBOX

@java-jaydevMCP server · External

List, search, download and upload files in a NAVER MYBOX (네이버 마이박스) cloud drive.

File storage & sharingv0.1.0MITPython
Freeno charge per call

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: creates or changes data: records, files, settings.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

PyPInaver-mybox-mcpv0.1.0

Run

uvx naver-mybox-mcp

MCP client config

{
  "mcpServers": {
    "naver-mybox": {
      "command": "uvx",
      "args": [
        "naver-mybox-mcp"
      ]
    }
  }
}
README4 min read

naver-mybox-mcp

An MCP server for NAVER MYBOX (네이버 마이박스) — list, search, download and upload files in your MYBOX cloud drive from any MCP client (Claude Code, Claude Desktop, and others).

MYBOX opened a public API in August 2026 (developers.mybox.naver.com). This wraps it as tools. Unofficial, not affiliated with NAVER.

Why

Phone photos land in MYBOX automatically. Getting them onto a machine meant clicking through the web UI. With this, an agent can fetch "every photo taken on 10–11 September" into a working folder in one step.

Install

Requires Python 3.10+.

bash
pip install naver-mybox-mcp

Get a token

Authentication is a personal access token, not OAuth.

  1. Sign in at MYBOX on the web.
  2. Settings → account and personal access token management → create token.
  3. Copy it immediately — it is shown once.

Up to five tokens per account; each lasts 30, 60, 90 or 180 days, and MYBOX emails you 7 days and 1 day before expiry. Anyone holding the token can reach the whole drive, so treat it as a password and never commit it.

Provide it as the MYBOX_PAT environment variable, or put it on one line in ~/.mybox/token.

Configure your MCP client

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

In Claude Code: claude mcp add mybox --env MYBOX_PAT=mbx_pat_... -- naver-mybox-mcp

Tools

ToolWhat it does
mybox_storageQuota, used bytes, per-category file counts, max upload size
mybox_listEntries directly inside a folder, or the drive root
mybox_searchSearch by keyword, category and/or date range (KST)
mybox_file_infoAttributes of one file or folder
mybox_downloadDownload one file into a local directory
mybox_uploadUpload one local file
mybox_create_folderCreate a folder

Deliberately missing: delete

The API can delete files, empty the trash and set its auto-delete period. Those tools are not exposed here. An agent that can read and write files is useful; one that can destroy them is a different risk, and the web UI is right there. Open an issue if you need them behind a flag.

Quotas

The docs publish per-plan limits and warn that bursts or abuse may be blocked without prior notice, so the client paces itself below the lowest documented per-minute limits (9/min for search, 55/min otherwise). Free accounts can use the API; the plan only changes the limits.

PlanDownloadsSearchOther APIs
30GB500/day10/min60/min each
80GB1,000/day10/min60/min each
180GB–330GB1,000/day30/min240/min each
2TB2,000/day30/min240/min each

Download limits are daily and the client cannot pace around them. Search first, count the results, and fetch in batches if the set is large.

Notes on the API

  • Base URL https://open-api.mybox.naver.com/v1
  • Upload is two steps: POST /drive/files returns an uploadUrl (48h, single use); the bytes go there as multipart field Filedata.
  • Download is two steps: GET /drive/files/{id}/download returns a downloadUrl (10 minutes, single use).
  • Paging: responseMetaData.nextCursor goes back as cursor.
  • Search needs at least one of keyword, category or a date bound.
  • Encrypted folders and folders shared with you are not exposed by the API — they exist only in the web and mobile apps. An empty listing does not mean an empty drive.

The MYBOX API opened on 2026-08-10 and tooling appeared quickly. NAVER publishes no MCP server or SDK of its own, and its launch post does not mention MCP. Community work that exists:

ProjectWhat it is
minking/mybox-mcpMCP server in TypeScript covering all 20 endpoints, including delete and trash
oliverne/myboxctlCLI for file operations (@oliverne/myboxctl on npm)
overworks/php-myboxPHP SDK, plus a Go CLI and a Flysystem adapter by the same author
chiwanpark/mybox-s3S3-compatible API in front of MYBOX

This one is Python, exposes a deliberately smaller surface (no delete), paces itself under the documented rate limits, and ships tests that need neither a token nor the network. Pick whichever fits; if you want every endpoint including destructive ones, the TypeScript server above has them.

Development

bash
pip install -e ".[dev]"
pytest

Tests run against httpx.MockTransport; no token or network needed.

Releases are published from GitHub Actions on a GitHub release: PyPI via Trusted Publishing (no stored token) and the MCP registry via GitHub OIDC.

License

MIT

Similar modules

Browse File storage & sharing