Allows an AI client to list, search, download, and upload files within a NAVER MYBOX cloud drive.
Also known as java-jaydev/naver-mybox-mcp, naver-mybox-mcp
- Stars
- 1
- Tools
- 7
- Downloads, 30 days
- 152
- Latest version
- 0.1.0
- Last commit
- Sep 13, 2026
- License
- MIT
What is NAVER MYBOX MCP?
NAVER MYBOX allows an AI client to list, search, download, and upload files within a NAVER MYBOX cloud drive. It exposes 7 tools, such as mybox_storage, mybox_list, mybox_search.
Summary generated from the project's README
About NAVER MYBOX MCP server
Managing files within your NAVER MYBOX cloud storage from an AI client is what this Python-based MCP server enables. It allows developers to interact with their cloud drive through tools like mybox_list, mybox_search, mybox_download, and mybox_upload. By connecting this server to clients such as Claude Desktop or Claude Code, you can automate tasks like retrieving specific photos or organizing files without using a web browser.
Setup requires Python 3.10 or higher and a personal access token obtained from your MYBOX account settings. You must provide this token via the MYBOX_PAT environment variable or a local configuration file. The server is designed to respect API rate limits, such as the 9 per minute limit for searches, to prevent account blocks. Unlike some other implementations, this version intentionally excludes deletion tools to minimize the risk of accidental data loss, focusing instead on safe read and write operations.
What you can do with it
- 1Retrieve specific dated photosAn agent can fetch every photo taken on a specific date range directly into a local working folder.
- 2Monitor cloud storage capacityYou can check your current quota and used bytes to manage your storage plan.
- 3Search for specific filesFind files using keywords, categories, or specific date ranges within the cloud drive.
- 4Automate file transfersMove files from your local machine to the cloud or download them for processing.
Written from the project's README. Every use case is checked against a quote from it.
How to install NAVER MYBOX MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall NAVER MYBOX MCP in Claude Code
$ claude mcp add --env 'MYBOX_PAT=<YOUR_MYBOX_PAT>' naver-mybox-mcp -- uvx naver-mybox-mcpInstall NAVER MYBOX MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"naver-mybox-mcp": {
"command": "uvx",
"args": [
"naver-mybox-mcp"
],
"env": {
"MYBOX_PAT": "<YOUR_MYBOX_PAT>"
}
}
}
}Install NAVER MYBOX MCP in VS Code
.vscode/mcp.json
{
"servers": {
"naver-mybox-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"naver-mybox-mcp"
],
"env": {
"MYBOX_PAT": "<YOUR_MYBOX_PAT>"
}
}
}
}Install NAVER MYBOX MCP in VS Code CLI
$ code --add-mcp '{"name":"naver-mybox-mcp","type":"stdio","command":"uvx","args":["naver-mybox-mcp"],"env":{"MYBOX_PAT":"<YOUR_MYBOX_PAT>"}}'Install NAVER MYBOX MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"naver-mybox-mcp": {
"command": "uvx",
"args": [
"naver-mybox-mcp"
],
"env": {
"MYBOX_PAT": "<YOUR_MYBOX_PAT>"
}
}
}
}Install NAVER MYBOX MCP in Codex
$ codex mcp add naver-mybox-mcp --env 'MYBOX_PAT=<YOUR_MYBOX_PAT>' -- uvx naver-mybox-mcpInstall NAVER MYBOX MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.naver-mybox-mcp] command = "uvx" args = ["naver-mybox-mcp"] [mcp_servers.naver-mybox-mcp.env] MYBOX_PAT = "<YOUR_MYBOX_PAT>"
Install NAVER MYBOX MCP in Gemini CLI
$ gemini mcp add -s user -e 'MYBOX_PAT=<YOUR_MYBOX_PAT>' naver-mybox-mcp uvx -- naver-mybox-mcpInstall NAVER MYBOX MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"naver-mybox-mcp": {
"command": "uvx",
"args": [
"naver-mybox-mcp"
],
"env": {
"MYBOX_PAT": "<YOUR_MYBOX_PAT>"
}
}
}
}NAVER MYBOX MCP tools 7
Detected from the READMEmybox_storagemybox_listmybox_searchmybox_file_infomybox_downloadmybox_uploadmybox_create_folder
| mybox_storage | — | |
| mybox_list | — | |
| mybox_search | — | |
| mybox_file_info | — | |
| mybox_download | — | |
| mybox_upload | — | |
| mybox_create_folder | — |
Configuration
MYBOX_PATSecretMYBOX personal access token, created in the MYBOX web UI under Settings > account and personal access token management. Falls back to ~/.mybox/token when unset.
| Name | Description | |
|---|---|---|
| MYBOX_PAT | MYBOX personal access token, created in the MYBOX web UI under Settings > account and personal access token management. Falls back to ~/.mybox/token when unset. | Secret |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablejava-jaydev/naver-mybox-mcp is public and reachablegithub.com/java-jaydev/naver-mybox-mcp ↗Pass
- Package names this repository as its sourcenaver-mybox-mcp names java-jaydev/naver-mybox-mcp as sourcepypi.org/project/naver-mybox-mcp/ ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for naver-mybox-mcppypi.org/project/naver-mybox-mcp/ ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-13github.com/java-jaydev/naver-mybox-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from naver-mybox-mcpPass
- No critical advisory in the package or its dependencies32 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model7 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubnaver-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+.
pip install naver-mybox-mcp
Get 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 |
|---|---|
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/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 |
|---|---|
| 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
NAVER MYBOX MCP questions
How do I add NAVER MYBOX MCP to Claude Code?
Run claude mcp add --env 'MYBOX_PAT=<YOUR_MYBOX_PAT>' naver-mybox-mcp -- uvx naver-mybox-mcp in your terminal. Add --scope user to make it available in every project.
How do I add NAVER MYBOX MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does NAVER MYBOX MCP provide?
It exposes 7 tools, including mybox_storage, mybox_list, mybox_search, mybox_file_info, mybox_download.
Does the API support encrypted or shared folders?
No, encrypted folders and folders shared with you are not accessible via the API and only appear in web or mobile apps.
What are the rate limits for using the server?
The client automatically paces itself below the documented limits, which are typically 9/min for search and 55/min for other operations, though these vary by plan.