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
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-mcpWhat 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.pdfto Notion and attach it to pagePAGE_ID. - Add
./exports/demo.mp4to Notion as a video with the caption “Demo”. - Attach the existing upload
FILE_UPLOAD_IDto blockBLOCK_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-mcpReplace <…> with your own values
Platform CLI
codex mcp add mcp-server --env NOTION_KEY=<NOTION_KEY> --env NOTION_UPLOAD_ALLOWED_DIRS=<NOTION_UPLOAD_ALLOWED_DIRS> -- npx -y notion-large-file-upload-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-large-file-upload-mcp"
],
"env": {
"NOTION_KEY": "<NOTION_KEY>",
"NOTION_UPLOAD_ALLOWED_DIRS": "<NOTION_UPLOAD_ALLOWED_DIRS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"notion-large-file-upload-mcp"
],
"env": {
"NOTION_KEY": "<NOTION_KEY>",
"NOTION_UPLOAD_ALLOWED_DIRS": "<NOTION_UPLOAD_ALLOWED_DIRS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e NOTION_KEY=<NOTION_KEY> -e NOTION_UPLOAD_ALLOWED_DIRS=<NOTION_UPLOAD_ALLOWED_DIRS> mcp-server npx -y notion-large-file-upload-mcpReplace <…> 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.