# Notion Large File Upload

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13 repo stars
- Author: shoubhiksaha
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/shoubhiksaha/notion-multipart-uploader/tree/HEAD/mcp-server
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/notion-large-file-upload

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `NOTION_KEY`, `NOTION_UPLOAD_ALLOWED_DIRS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Notion

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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`.

## Similar
- [notion-meeting-intelligence](https://affpapa.org/en/nevibecode/skills/openai-notion-meeting-intelligence.md) — skill · 3400 installs
- [notion-spec-to-implementation](https://affpapa.org/en/nevibecode/skills/notion-spec-to-implementation-2.md) — skill · 389 installs
- [notion](https://affpapa.org/en/nevibecode/skills/membrane-notion.md) — skill · 357 installs
- [notion-memory](https://affpapa.org/en/nevibecode/plugins/notion-memory.md) — plugin · ★ 11 repo stars
- [notion-knowledge-capture](https://affpapa.org/en/nevibecode/skills/notion-knowledge-capture-2.md) — skill · 612 installs
- [pp-notion](https://affpapa.org/en/nevibecode/skills/pp-notion.md) — skill · 394 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
