{"_id":"@joescars/onedrive-mcp","_rev":"4-15f628b940ce8b566ae5d9f4e2342766","name":"@joescars/onedrive-mcp","dist-tags":{"latest":"0.1.2"},"versions":{"0.0.0-stage":{"name":"@joescars/onedrive-mcp","version":"0.0.0-stage","_id":"@joescars/onedrive-mcp@0.0.0-stage","stub":true,"maintainers":[{"name":"joescars","email":"contact@joeraio.com"}],"dist":{"shasum":"91b44a27a70b44cc6a4c9552e679f7d276b866a6","tarball":"https://registry.npmjs.org/@joescars/onedrive-mcp/-/onedrive-mcp-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-eoeI6S+hVHoVhgWZepTVf2sGRmwJBq4E6UK5mq/urZyOd1NFUdOcoi3KoZDJAGGMqqY7HtH43JkWhSnMBoc4kg==","signatures":[{"sig":"MEUCIQCHBmH54MtgCAOywAPKGAwOv5SmEFbkN0ZKmV7UeGdI8QIge+SkJtow1gcjEtUuWgG0uiZLDBCc3W5RX4TckmaLkHY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":344},"_npmUser":{"name":"joescars","email":"contact@joeraio.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@joescars/onedrive-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","onedrive","microsoft-graph","read-only"],"license":"MIT","_id":"@joescars/onedrive-mcp@0.1.0","maintainers":[{"name":"joescars","email":"contact@joeraio.com"}],"homepage":"https://github.com/joescars/onedrive-mcp#readme","bugs":{"url":"https://github.com/joescars/onedrive-mcp/issues"},"bin":{"onedrive-mcp":"bin/onedrive-mcp.mjs","onedrive-mcp-setup":"bin/onedrive-mcp-setup.mjs"},"dist":{"shasum":"9f527c0aeaabba9e6c82d4b650069f7326064075","tarball":"https://registry.npmjs.org/@joescars/onedrive-mcp/-/onedrive-mcp-0.1.0.tgz","fileCount":6,"integrity":"sha512-XJ/NkaLP1pFpA4KsvP03E0kQ9PatGu2flVLMAdmupEYzErea89j+ew3kuIvmuwM5xztBJ0gjzySm04btG6Pl4g==","signatures":[{"sig":"MEUCIAr6QdP6Hogmk10s5u4EAsxLt6DteuLRXceFMl7f5p7LAiEAkgP/Av1lV+YWPhvqxDIpRWcn0DbTh8/hi69ajFoaNt0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCLzd4f/cpA8P/kBwBCdkunGI1MwRB/8uepqJxHYR8EggIhAMAj4hFOlfDvacN1D1fyCuPJizLBRV/+B3FK4wie98U+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11560},"type":"module","engines":{"node":">=18"},"gitHead":"af732462a5ff5a285f8c770227b3e6105997ce4d","scripts":{"test":"node --test"},"_npmUser":{"name":"joescars","email":"contact@joeraio.com"},"repository":{"url":"git+https://github.com/joescars/onedrive-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"Read-only MCP server for personal Microsoft OneDrive accounts","directories":{},"_nodeVersion":"25.9.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/onedrive-mcp_0.1.0_1792954060550_0.6548874309884551","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@joescars/onedrive-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","onedrive","microsoft-graph","read-only"],"license":"MIT","_id":"@joescars/onedrive-mcp@0.1.1","maintainers":[{"name":"joescars","email":"contact@joeraio.com"}],"homepage":"https://github.com/joescars/onedrive-mcp#readme","bugs":{"url":"https://github.com/joescars/onedrive-mcp/issues"},"bin":{"onedrive-mcp":"bin/onedrive-mcp.mjs","onedrive-mcp-setup":"bin/onedrive-mcp-setup.mjs"},"dist":{"shasum":"7d8bbc44fc6c62d40eeba343f88e7487f4a51077","tarball":"https://registry.npmjs.org/@joescars/onedrive-mcp/-/onedrive-mcp-0.1.1.tgz","fileCount":6,"integrity":"sha512-LcxAVny2kfJIWSryD+0ZSYcBsSEhl3xJR5HLnQrn4wKJ88KpmsGlqua7yTeGUdMfyw7xyeXSz1Df9mgC+VXRpQ==","signatures":[{"sig":"MEUCIQC1gGotsK/0l7Pzu5XdG2rhmViSMxkiNNRz+RlUONe+kgIgbkPLEOaddRZOxBcb1NBrIjMJn0IoVrMZtiIl09Jw5Ro=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCID0XClD2bprVftMD+dKvO5GHMGXy5bOq/jR88n+cjZLNAiEAtPVFi34Ge0CrMeH5sWRLw5hHrFr/hREL9VijgEarO1U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@joescars%2fonedrive-mcp@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":10720},"type":"module","engines":{"node":">=18"},"gitHead":"74d8ea6e46db59419a7e908a52332ceeab4785a1","scripts":{"test":"node --test"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"cc94abdd-d233-43fc-9394-e7046289395d"}},"repository":{"url":"git+https://github.com/joescars/onedrive-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"Read-only MCP server for personal Microsoft OneDrive accounts","directories":{},"_nodeVersion":"24.21.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/onedrive-mcp_0.1.1_1792955086636_0.3349416378329255","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"_id":"@joescars/onedrive-mcp@0.1.2","bin":{"onedrive-mcp":"bin/onedrive-mcp.mjs","onedrive-mcp-setup":"bin/onedrive-mcp-setup.mjs"},"bugs":{"url":"https://github.com/joescars/onedrive-mcp/issues"},"dist":{"shasum":"8e9540475459be707ceeddb4ea571c7b3421525a","tarball":"https://registry.npmjs.org/@joescars/onedrive-mcp/-/onedrive-mcp-0.1.2.tgz","fileCount":6,"integrity":"sha512-JqR8EW4KMdpmdq85njpuJmqXB7ElgB+25OJcdTBjtBfQDkUJtwcchveQUEbyq8VvLKPK0aWOgryACjnVVgQiZQ==","signatures":[{"sig":"MEYCIQDoHxbPvXMHfqmxrazeglOeDW+e3t5QXofotC9DUvIM0wIhAMhyAQjg5L8stJrUOo+jQlayZvIfw129x1HmzuVMv7S0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIENPaLVpVZulTskROh9MKTRRWeYd6uboaOdIF9UT15YMAiEAmtXLPwvNvyHorPIeglO/h3u9zxHYJ4YNKiF1DxrrQkQ="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@joescars%2fonedrive-mcp@0.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":10806},"name":"@joescars/onedrive-mcp","type":"module","engines":{"node":">=18"},"gitHead":"07e76a704195ee06c842f522e943b27fd7cefa9a","license":"MIT","scripts":{"test":"node --test"},"version":"0.1.2","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"cc94abdd-d233-43fc-9394-e7046289395d"}},"homepage":"https://github.com/joescars/onedrive-mcp#readme","keywords":["mcp","model-context-protocol","onedrive","microsoft-graph","read-only"],"repository":{"url":"git+https://github.com/joescars/onedrive-mcp.git","type":"git"},"_npmVersion":"11.21.1","description":"Read-only MCP server for personal Microsoft OneDrive accounts","directories":{},"maintainers":[{"name":"joescars","email":"contact@joeraio.com"}],"_nodeVersion":"24.22.1","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/onedrive-mcp_0.1.2_1793469934099_0.04815977151341433"}}},"time":{"created":"2026-10-25T18:46:22.933Z","modified":"2026-10-31T18:05:34.529Z","0.0.0-stage":"2026-10-25T18:46:22.933Z","0.1.0":"2026-10-25T18:47:40.647Z","0.1.1":"2026-10-25T19:04:46.713Z","0.1.2":"2026-10-31T18:05:34.198Z"},"bugs":{"url":"https://github.com/joescars/onedrive-mcp/issues"},"license":"MIT","homepage":"https://github.com/joescars/onedrive-mcp#readme","keywords":["mcp","model-context-protocol","onedrive","microsoft-graph","read-only"],"repository":{"url":"git+https://github.com/joescars/onedrive-mcp.git","type":"git"},"description":"Read-only MCP server for personal Microsoft OneDrive accounts","maintainers":[{"name":"joescars","email":"contact@joeraio.com"}],"readme":"# OneDrive Read-Only MCP Server\n\n[![Tests and dependency audit](https://github.com/joescars/onedrive-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/joescars/onedrive-mcp/actions/workflows/ci.yml)\n[![PyPI](https://img.shields.io/pypi/v/joescars-onedrive-mcp)](https://pypi.org/project/joescars-onedrive-mcp/)\n[![npm](https://img.shields.io/npm/v/%40joescars%2Fonedrive-mcp)](https://www.npmjs.com/package/@joescars/onedrive-mcp)\n\nA local [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server\nfor searching, inspecting, and downloading files from a personal Microsoft\nOneDrive account. Install the published package with `npx`; no repository\ncheckout or separate Python installation is needed. The launcher uses Astral\n`uv` to install and run the matching Python package in an isolated environment.\n\n> [!IMPORTANT]\n> **This server is read-only.** It exposes five read-style tools and only\n> makes HTTP GET requests to Microsoft Graph. It can download files from\n> OneDrive to the local machine, but cannot upload, edit, rename, move, or\n> delete OneDrive content.\n\nThis project targets **personal Microsoft accounts and consumer OneDrive**.\nOneDrive for Business and SharePoint are outside its default scope. Linux is\nthe supported production platform; Windows and other non-POSIX systems are for\ndevelopment only because POSIX file modes do not establish Windows ACLs.\n\n## Install and connect\n\n### Requirements\n\n- Node.js 18 or newer, which provides `npx`.\n- [Astral `uv`](https://docs.astral.sh/uv/getting-started/installation/),\n  which provides `uvx`. It creates an isolated Python environment and can\n  provision a compatible Python interpreter; you do not need to install the\n  server's Python dependencies yourself.\n- A personal Microsoft account and a Microsoft Entra app registration that\n  you own or are authorized to use.\n\n### 1. Register your Microsoft application\n\nFollow [the app registration guide](docs/setup.md#1-register-an-azure-application).\nYou will use its public **Application (client) ID** below. Each user supplies\ntheir own ID; this project does not ship a shared client ID or client secret.\n\n### 2. Save your client ID and sign in\n\nThe following commands are for Linux/macOS shells. They create a private\nper-user configuration directory and `.env` file; replace the placeholder\nwith your app registration's client ID:\n\n```bash\nCONFIG_DIR=\"${ONEDRIVE_MCP_CONFIG_DIR:-${XDG_CONFIG_HOME:-$HOME/.config}/onedrive-mcp}\"\ninstall -d -m 700 \"$CONFIG_DIR\"\nif [ ! -e \"$CONFIG_DIR/.env\" ]; then\n  (umask 077; printf 'AZURE_CLIENT_ID=%s\\nAZURE_TENANT_ID=consumers\\n' 'YOUR-APPLICATION-CLIENT-ID' > \"$CONFIG_DIR/.env\")\nelse\n  echo \"Keep the existing $CONFIG_DIR/.env; verify AZURE_CLIENT_ID is set there.\"\nfi\nnpx --yes --package @joescars/onedrive-mcp@latest onedrive-mcp-setup\n```\n\nThe setup command follows npm's `latest` tag. The MCP client example below\npins the running server to `0.1.1` so upgrades are intentional; use that pin\nafter the matching npm and PyPI releases are available.\n\nThe setup command displays Microsoft's device-code sign-in instructions and\nstores the token cache in the stable per-user data directory. You normally\nsign in once; repeat only if your credentials expire or are revoked. See\n[Setup](docs/setup.md) for app registration, path overrides, and migration\nfrom a source install.\n\n### 3. Add the server to your MCP client\n\nUse the following stdio configuration in clients that support an\n`mcpServers` object:\n\n```json\n{\n  \"mcpServers\": {\n    \"onedrive\": {\n      \"command\": \"npx\",\n      \"args\": [\"--yes\", \"@joescars/onedrive-mcp@0.1.1\"]\n    }\n  }\n}\n```\n\nPinning the package version makes upgrades intentional. The MCP client starts\nthe server when needed; do not run a separate server process. If the client\ncannot find `npx` on its `PATH`, use the absolute path to `npx`. Keep client\nIDs, `.env` contents, and tokens out of client configuration. For client-\nspecific examples, see [Client configuration](docs/clients.md); the npm\nlauncher has its own [installation guide](docs/npm.md).\n\n## What it can do\n\nThe server provides these five MCP tools:\n\n| Tool | Purpose |\n| --- | --- |\n| `search_onedrive(query, top=20, next_link=None)` | Search by file name or indexed content, one page at a time. |\n| `list_folder(path='/', top=50, next_link=None)` | List a folder's children with bounded pagination. |\n| `get_item_metadata(path_or_id)` | Inspect metadata for a file or folder. |\n| `download_file(path_or_id, dest_filename=None)` | Download a file into the local download directory without overwriting an existing file. |\n| `get_drive_info()` | Read drive, owner, and quota information. |\n\nPaths such as `/Documents/report.pdf` and Graph item IDs are accepted where\ndocumented. Pagination continuations are opaque; pass them back to the same\ntool with the original arguments. The server returns a local path and metadata\nfor downloads, not the downloaded file's contents. See the [Tool reference](docs/tools.md)\nfor exact arguments and results.\n\n## Storage and security\n\n- Microsoft Graph requests use read-only delegated scopes and a GET-only\n  network helper. This is not a guarantee against future code changes.\n- `.env` configuration, the token cache, and downloads live outside the npm\n  cache and source checkout in stable per-user directories.\n- The token cache contains sensitive credentials. On Linux, files are\n  restricted with owner-only POSIX permissions; the cache is not encrypted.\n- Signed download URLs are not returned in tool results or errors. Downloads\n  have configurable per-file and total-directory limits, and existing files\n  are never overwritten.\n- Search results, file names, paths, and metadata become available to the MCP\n  client and may enter the model's context. Only connect accounts and files\n  you intend to make available.\n\nRead the full [Security guide](docs/security.md), and never share\n`token_cache.bin` or the contents of your `.env` file.\n\n## Other installation and deployment options\n\n- **Python/source installation:** follow [Setup](docs/setup.md). Useful for\n  development or when you prefer managing the checkout yourself.\n- **Open WebUI:** this server uses stdio; expose it through the authenticated\n  [`mcpo` bridge](docs/deployment.md) rather than pointing Open WebUI directly\n  at the stdio process.\n\n## Documentation\n\n| Guide | What it covers |\n| --- | --- |\n| [Setup](docs/setup.md) | Microsoft app registration, source installation, configuration, and sign-in. |\n| [Client configuration](docs/clients.md) | VS Code, Hermes, pi, stdio, and Open WebUI setup. |\n| [npm installation](docs/npm.md) | Published launcher requirements, sign-in, and client configuration. |\n| [Tool reference](docs/tools.md) | Tool inputs, response shapes, pagination, and downloads. |\n| [Security](docs/security.md) | Read-only design, local storage, and privacy considerations. |\n| [Development](docs/development.md) | Tests, dependency maintenance, and publishing releases. |\n| [Troubleshooting](docs/troubleshooting.md) | Authentication, Graph, client, and dependency issues. |\n\n## License\n\nMIT licensed; see [LICENSE](LICENSE). This is an independent community\nproject and is not affiliated with or endorsed by Microsoft.\n","readmeFilename":"README.md"}