Skip to main content
Glama
mybox-mcp

mybox-mcp

by java-jaydev

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.

Related MCP server: dropbox-mcp

Install

Requires Python 3.10+.

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

{
  "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

Tool

What it does

mybox_storage

Quota, used bytes, per-category file counts, max upload size

mybox_list

Entries directly inside a folder, or the drive root

mybox_search

Search by keyword, category and/or date range (KST)

mybox_file_info

Attributes of one file or folder

mybox_download

Download one file into a local directory

mybox_upload

Upload one local file

mybox_create_folder

Create 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.

Plan

Downloads

Search

Other APIs

30GB

500/day

10/min

60/min each

80GB

1,000/day

10/min

60/min each

180GB–330GB

1,000/day

30/min

240/min each

2TB

2,000/day

30/min

240/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:

Project

What it is

minking/mybox-mcp

MCP server in TypeScript covering all 20 endpoints, including delete and trash

oliverne/myboxctl

CLI for file operations (@oliverne/myboxctl on npm)

overworks/php-mybox

PHP SDK, plus a Go CLI and a Flysystem adapter by the same author

chiwanpark/mybox-s3

S3-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

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

Available Tools

7 tools
mybox_create_folderA

Create a folder and return its id.

Args: name: Folder name. parent_id: Parent folder id. Omit to create it at the drive root.

Inputs: name (required), parent_id. Returns: object

mybox_downloadA

Download one file into a local directory and return the path written.

A local file with the same name and size is left in place and reported as skipped. Download quotas are per day and small on entry plans, so avoid re-downloading.

Inputs: dest_dir (required), resource_id (required). Returns: object

mybox_file_infoC

Fetch the attributes of one file or folder by id.

Inputs: resource_id (required). Returns: object

mybox_listA

List files and folders directly inside a folder, or the drive root.

Args: folder_id: Folder to list. Omit for the drive root. count: Maximum entries to return (the API pages internally, 1000 per page). sort: "field,direction" where field is name, createdAt, modifiedAt or accessedAt.

Inputs: sort, count, folder_id. Returns: object

mybox_storageA

Report MYBOX quota, used bytes, per-category file counts and max upload size.

Inputs: no named parameters. Returns: object

mybox_uploadA

Upload one local file to MYBOX.

Args: path: Local file to upload. parent_id: Destination folder id. Omit to upload to the drive root. overwrite: Replace an existing file with the same name instead of keeping both.

Inputs: path (required), overwrite, parent_id. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct operation: aggregate quota, folder listing, single-item info, search, download, upload, and folder creation. Overlap is minimal; the list/search distinction is clear (browse vs query).

    Naming Consistency4/5

    All names use the mybox_ prefix and snake_case, making them predictable and readable. There is a minor mix of verb-based (list, search, download, upload) and noun-based (storage, file_info) names, but no confusing inconsistency.

    Tool Count5/5

    Seven tools cover the essential storage operations without redundancy. Each tool earns its place and the set is well-scoped for a cloud storage MCP.

    Completeness3/5

    Core read, write, and create operations are present, but the lifecycle is incomplete: there is no delete, move/rename, or copy operation. These are notable gaps for a file management server.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Unofficial MCP server for NAVER WORKS Drive admin tasks, enabling shared-drive governance, permission management, and file operations via service-account delegation.
      16
      MIT
    • F
      license
      C
      quality
      C
      maintenance
      Enables AI clients to manage Naver Cloud MYBOX files and folders through the MYBOX Open API, including listing, uploading/downloading, copying/moving, renaming, searching, favoriting, and trash operations.
      20
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to browse, read, write, search, and share files in a pCloud account over HTTPS, including folder management, trash access, and public link creation.
      1
      MIT