Skip to content
Back to search

pandafile-mcp

Official Pandafile MCP server: send big files and manage transfers from Claude, Cursor, VS Code and other AI agents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pandafileco--pandafile-mcp/badge.svg)](/listings/pandafileco--pandafile-mcp)

HTML

<a href="/listings/pandafileco--pandafile-mcp"><img src="/api/listings/pandafileco--pandafile-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Replace `pf_live_YOUR_KEY` with your key in each example.

Claude Desktop

Settings → Developer → Edit Config (`claude_desktop_config.json`):

{
  "mcpServers": {
    "pandafile": {
      "command": "npx",
      "args": ["-y", "@pandafile/mcp"],
      "env": { "PANDAFILE_API_KEY": "pf_live_YOUR_KEY" }
    }
  }
}

Restart Claude Desktop. The file is in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

Claude Code

claude mcp add pandafile --env PANDAFILE_API_KEY=pf_live_YOUR_KEY -- npx -y @pandafile/mcp

Add `--scope user` to have it in every project.

Cursor

`.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` for every project):

{
  "mcpServers": {
    "pandafile": {
      "command": "npx",
      "args": ["-y", "@pandafile/mcp"],
      "env": { "PANDAFILE_API_KEY": "pf_live_YOUR_KEY" }
    }
  }
}

VS Code (GitHub Copilot agent mode)

`.vscode/mcp.json` – VS Code asks for the key once and stores it securely:

{
  "inputs": [
    { "type": "promptString", "id": "pandafile-api-key", "description": "Pandafile API key (pf_live_… or pf_test_…)", "password": true }
  ],
  "servers": {
    "pandafile": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@pandafile/mcp"],
      "env": { "PANDAFILE_API_KEY": "${input:pandafile-api-key}" }
    }
  }
}

Windsurf

`~/.codeium/windsurf/mcp_config.json`:

{
  "mcpServers": {
    "pandafile": {
      "command": "npx",
      "args": ["-y", "@pandafile/mcp"],
      "env": { "PANDAFILE_API_KEY": "pf_live_YOUR_KEY" }
    }
  }
}

Other clients (ChatGPT, Codex, Zed, …)

Any client that starts local (stdio) MCP servers works with the command `npx -y @pandafile/mcp` and the environment variable `PANDAFILE_API_KEY`. For example the OpenAI Codex CLI:

codex mcp add pandafile --env PANDAFILE_API_KEY=pf_live_YOUR_KEY -- npx -y @pandafile/mcp

ChatGPT's connectors talk to remote (HTTPS) MCP servers; this package is a local server, so use it from a client that runs local servers.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 173 lines
  1. # @pandafile/mcp
  2. The official [Model Context Protocol](https://modelcontextprotocol.io) server for [Pandafile](https://pandafile.co).
  3. It lets AI agents – Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and any other MCP client – send big files
  4. and folders with a link, and manage your transfers and file requests.
  5. > "Send the `renders/` folder to client@example.com with Pandafile, title it *Final renders*, keep it for 60 days."
  6. The agent calls `send_files`, the files are uploaded with resumable, chunked uploads (any size your plan allows), and you
  7. get the link back: `https://pandafile.co/d/k3x9q2m7ab`.
  8. - Runs locally over stdio (`npx -y @pandafile/mcp`); Node 18 or newer.
  9. - Built on the official [`@pandafile/sdk`](https://www.npmjs.com/package/@pandafile/sdk): retries, idempotency keys,
  10. resumable [tus](https://tus.io) uploads.
  11. - Progress notifications while uploading, readable errors (the API's own message), no crashes on API errors.
  12. ## Requirements
  13. - A Pandafile **Pro** or **Team** plan (the API is included) and an API key from
  14. [Dashboard → Domain & API](https://pandafile.co/dashboard#domain).
  15. - Node.js 18+ (`npx` comes with it).
  16. Use a **test key** (`pf_test_…`) while you try it out: transfers are real uploads, but nobody is emailed, they expire
  17. after 24 hours and count toward no limit. File requests need a live key (`pf_live_…`).
  18. ## Install
  19. Replace `pf_live_YOUR_KEY` with your key in each example.
  20. ### Claude Desktop
  21. Settings → Developer → Edit Config (`claude_desktop_config.json`):
  22. ```json
  23. {
  24. "mcpServers": {
  25. "pandafile": {
  26. "command": "npx",
  27. "args": ["-y", "@pandafile/mcp"],
  28. "env": { "PANDAFILE_API_KEY": "pf_live_YOUR_KEY" }
  29. }
  30. }
  31. }
  32. ```
  33. Restart Claude Desktop. The file is in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.
  34. ### Claude Code
  35. ```sh
  36. claude mcp add pandafile --env PANDAFILE_API_KEY=pf_live_YOUR_KEY -- npx -y @pandafile/mcp
  37. ```
  38. Add `--scope user` to have it in every project.
  39. ### Cursor
  40. `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` for every project):
  41. ```json
  42. {
  43. "mcpServers": {
  44. "pandafile": {
  45. "command": "npx",
  46. "args": ["-y", "@pandafile/mcp"],
  47. "env": { "PANDAFILE_API_KEY": "pf_live_YOUR_KEY" }
  48. }
  49. }
  50. }
  51. ```
  52. ### VS Code (GitHub Copilot agent mode)
  53. `.vscode/mcp.json` – VS Code asks for the key once and stores it securely:
  54. ```json
  55. {
  56. "inputs": [
  57. { "type": "promptString", "id": "pandafile-api-key", "description": "Pandafile API key (pf_live_… or pf_test_…)", "password": true }
  58. ],
  59. "servers": {
  60. "pandafile": {
  61. "type": "stdio",
  62. "command": "npx",
  63. "args": ["-y", "@pandafile/mcp"],
  64. "env": { "PANDAFILE_API_KEY": "${input:pandafile-api-key}" }
  65. }
  66. }
  67. }
  68. ```
  69. ### Windsurf
  70. `~/.codeium/windsurf/mcp_config.json`:
  71. ```json
  72. {
  73. "mcpServers": {
  74. "pandafile": {
  75. "command": "npx",
  76. "args": ["-y", "@pandafile/mcp"],
  77. "env": { "PANDAFILE_API_KEY": "pf_live_YOUR_KEY" }
  78. }
  79. }
  80. }
  81. ```
  82. ### Other clients (ChatGPT, Codex, Zed, …)
  83. Any client that starts local (stdio) MCP servers works with the command `npx -y @pandafile/mcp` and the environment
  84. variable `PANDAFILE_API_KEY`. For example the OpenAI Codex CLI:
  85. ```sh
  86. codex mcp add pandafile --env PANDAFILE_API_KEY=pf_live_YOUR_KEY -- npx -y @pandafile/mcp
  87. ```
  88. ChatGPT's connectors talk to remote (HTTPS) MCP servers; this package is a local server, so use it from a client that
  89. runs local servers.
  90. ## Configuration
  91. | Variable | |
  92. | --- | --- |
  93. | `PANDAFILE_API_KEY` | Required. `pf_live_…`, or `pf_test_…` for test mode. Without it the server still starts, and every tool answers with setup instructions. |
  94. | `PANDAFILE_BASE_URL` | Optional. Default `https://pandafile.co/api/v1`. Only for testing against a local Pandafile server. |
  95. ## Tools
  96. | Tool | What it does | |
  97. | --- | --- | --- |
  98. | `send_files` | Upload local files and folders (absolute paths; folders keep their structure) and get the link. Options: `title`, `message`, `recipients`, `expires_in_days` / `expires_at`, `password`. Sends MCP progress notifications when the client asks for them. | writes |
  99. | `send_from_urls` | Make a transfer from public https URLs – Pandafile downloads them itself. Returns `ready`, or `uploading` with a hint to call `get_import_status`. | writes |
  100. | `get_import_status` | Progress of a `send_from_urls` transfer. | read-only |
  101. | `list_transfers` | Your transfers, newest first: search (`query`), `view` active/history, `limit`, `cursor`. | read-only |
  102. | `get_transfer` | One transfer: files, recipients (who downloaded), latest downloads, approvals, link statistics. | read-only |
  103. | `add_recipients` | Email the link to more people. | writes |
  104. | `remind_recipient` | Email a recipient their link again. | writes |
  105. | `update_transfer` | Title, message, later expiry, set or remove the password. | writes |
  106. | `delete_transfer` | Delete a transfer and its files now. | **destructive** |
  107. | `create_file_request` | An upload page others can send you files with. | writes |
  108. | `list_file_requests` | Your file requests and their uploads. | read-only |
  109. | `close_file_request` | Stop a file request from taking uploads. | writes |
  110. | `get_account` | Plan, limits, usage and whether the key is a test key. | read-only |
  111. Every tool carries MCP annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`), so clients
  112. can ask before anything that changes or deletes data. API errors come back as tool errors with Pandafile's message,
  113. error code and request id.
  114. ## Privacy and security
  115. - Files go only to Pandafile (`pandafile.co`, or `PANDAFILE_BASE_URL` if you set it). Pandafile's servers are in
  116. Helsinki, Finland (EU). See the [privacy policy](https://pandafile.co/privacy).
  117. - The server reads only the paths the agent passes to `send_files`. It collects no telemetry.
  118. - The API key is sent only to the Pandafile API, never logged and never included in tool results. Diagnostics go to
  119. stderr; stdout carries only MCP messages.
  120. - Give the agent a key with the narrowest scope that works (keys can be `read`, `write` or `full`), or a test key while
  121. you experiment.
  122. ## Development
  123. ```sh
  124. npm install
  125. npm test # unit tests: mocked API, in-memory MCP client
  126. npm run test:e2e # end to end inside the Pandafile repository: real server + throwaway database, stdio
  127. ```
  128. ## Links
  129. - MCP guide: https://pandafile.co/developers/mcp
  130. - SDKs and CLI: https://pandafile.co/developers/sdks
  131. - API reference: https://pandafile.co/developers/api
  132. MIT © 3XAYA LTD

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.