mybox-mcp
This MCP server lets an MCP client browse, search, download, and upload files in a NAVER MYBOX drive, but deliberately does not delete anything.
Check storage quota, used bytes, per-category file counts, and max upload size (
mybox_storage)List files/folders directly inside a folder or the drive root, with sorting and count (
mybox_list)Search by keyword, category, date range in KST, date field, parent path, and result limit (
mybox_search)Get attributes of one file or folder by ID (
mybox_file_info)Download one file into a local directory, skipping identical existing files (
mybox_download)Upload one local file, optionally to a parent folder or overwriting (
mybox_upload)Create a folder, optionally under a parent folder (
mybox_create_folder)Does not expose delete, trash-empty, or trash auto-delete operations
Provides tools for interacting with the NAVER MYBOX Open API, enabling listing, searching, downloading, and uploading files in a MYBOX drive, as well as checking storage quota, retrieving file info, and creating folders.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mybox-mcp Download every photo in my MYBOX from Sept 10-11 into ./photos"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpGet a token
Authentication is a personal access token, not OAuth.
Sign in at MYBOX on the web.
Settings → account and personal access token management → create token.
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 |
| Quota, used bytes, per-category file counts, max upload size |
| Entries directly inside a folder, or the drive root |
| Search by keyword, category and/or date range (KST) |
| Attributes of one file or folder |
| Download one file into a local directory |
| Upload one local file |
| 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/v1Upload is two steps:
POST /drive/filesreturns anuploadUrl(48h, single use); the bytes go there as multipart fieldFiledata.Download is two steps:
GET /drive/files/{id}/downloadreturns adownloadUrl(10 minutes, single use).Paging:
responseMetaData.nextCursorgoes back ascursor.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.
Related projects
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 |
MCP server in TypeScript covering all 20 endpoints, including delete and trash | |
CLI for file operations ( | |
PHP SDK, plus a Go CLI and a Flysystem adapter by the same author | |
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]"
pytestTests 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 toolsmybox_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_searchA
Search files by keyword, category and/or date range. At least one is required.
Args: query: Keyword. Spaces and extensions are combined with AND. category: One of image, video, audio, document, archive, executable, etc. start_date: Inclusive start, YYYY-MM-DD, interpreted in KST. end_date: Inclusive end, YYYY-MM-DD, interpreted in KST. date_field: Which date the range applies to: "created" or "modified". parent_path: Restrict the search to this folder path and below. max_items: Stop after this many results.
Inputs: query, category, end_date, max_items, +3 more. 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
Scored across 7 tools
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).
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.
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.
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
Related MCP Connectors
Browse and manage files in your Moxt AI workspace from any MCP client.
Cloud file relay: chunked uploads, folders, share links, inline text reads, ZIP packing.
Read, search, reply to and organize Naver Mail with the same tools as the Gmail MCP (IMAP/SMTP).
Notes, files, GitHub, and Drive through one MCP connection.
Related MCP Servers
- AlicenseBqualityCmaintenanceUnofficial MCP server for NAVER WORKS Drive admin tasks, enabling shared-drive governance, permission management, and file operations via service-account delegation.16MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible clients to interact with Dropbox, providing tools for file listing, search, upload, download, folder creation, deletion, move/copy, sharing, and account info.1MIT
- FlicenseCqualityCmaintenanceEnables 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-
- AlicenseNot gradedqualityCmaintenanceEnables 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.1MIT