Skip to main content
MCP server CX Codex

Notion Large File Upload — Claude Code MCP server: setup

Notion Large File Upload is an MCP server for Claude Code that uploads local files to Notion pages or blocks without putting file contents in model context.

MIT ★ 13 updated 2026-10-28

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add notion-large-file-upload -e NOTION_KEY=<NOTION_KEY> -e NOTION_UPLOAD_ALLOWED_DIRS=<NOTION_UPLOAD_ALLOWED_DIRS> -- npx -y notion-large-file-upload-mcp
Open on GitHub

What Notion Large File Upload does

The server offers separate tools to upload a file, attach an existing upload, or upload and attach in one operation. Pass an absolute file path and the target page or block; optional fields let you choose a block type and add a caption. Uploads can reach 5 GB when the Notion workspace plan allows it.

Set NOTION_KEY and NOTION_UPLOAD_ALLOWED_DIRS before use. The latter must contain absolute paths to approved folders, separated by : or, on Windows, ;. The server resolves symbolic links before checking access, so an allowed folder cannot be used as a route to files outside it. Those folder limits matter: the server reads files on the machine where it runs.

An uploaded file must be attached within an hour. Free Notion workspaces cap each file at 5 MiB, while paid plans allow uploads up to 5 GB. The MCP client must be able to run local servers; files added to a claude.ai chat are not on the server’s disk.

What it helps with

  • send a local file to Notion
  • attach an upload to a page or block
  • add a video, image, or PDF block to a Notion page
  • attach an existing upload using its file ID

Example prompts for the agent

  • Upload ./reports/summary.pdf to Notion and attach it to page PAGE_ID.
  • Add ./exports/demo.mp4 to Notion as a video with the caption “Demo”.
  • Attach the existing upload FILE_UPLOAD_ID to block BLOCK_ID.

How to install Notion Large File Upload

Platform CLI

claude mcp add notion-large-file-upload -e NOTION_KEY=<NOTION_KEY> -e NOTION_UPLOAD_ALLOWED_DIRS=<NOTION_UPLOAD_ALLOWED_DIRS> -- npx -y notion-large-file-upload-mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Notion Large File Upload

How do I install Notion Large File Upload in Claude Code?

Run `claude mcp add notion-large-file-upload -e NOTION_KEY=<NOTION_KEY> -e NOTION_UPLOAD_ALLOWED_DIRS=<NOTION_UPLOAD_ALLOWED_DIRS> -- npx -y notion-large-file-upload-mcp`. Set your Notion token and absolute paths to the folders the server may read.

What does Notion Large File Upload do?

It sends local files to Notion and can place them on a page or block. You can also attach a file that was uploaded earlier by providing its upload ID.

What is the upload limit on a free Notion workspace?

The server checks the workspace limit before uploading. Free workspaces allow up to 5 MiB per file; paid plans allow files up to 5 GB.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open