MCP Notion Upload Server

Notion API MCP (Model Context Protocol) .

• Notion API ( 20MB)
• URL

(NEW!)

• ** **: + + URL
• Notion

• URL 
  

# uv   ()
uv sync

# pip  
pip install -e .
#    
pip install httpx mcp[cli]

Claude Desktop

1.

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

2. (uv )

{
  "mcpServers": {
    "notion-upload": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp_notion_upload",
        "run",
        "mcp_notion_upload.py"
      ]
    }
  }
}

3. Python

{
  "mcpServers": {
    "notion-upload": {
      "command": "python",
      "args": [
        "/path/to/mcp_notion_upload.py"
      ]
    }
  }
}

4.

{
  "mcpServers": {
    "notion-upload": {
      "command": "/path/to/.venv/bin/python",
      "args": [
        "/path/to/mcp_notion_upload.py"
      ]
    }
  }
}

5. ( )

    :

{
  "mcpServers": {
    "notion-upload": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp_notion_upload",
        "run",
        "mcp_notion_upload.py"
      ],
      "env": {
        "NOTION_API_TOKEN": "secret_your_notion_token_here"
      }
    }
  }
}

Claude Desktop , :

()

** URL!**

: ".pdf   ID 2785bbc0e5c281f48dfae9a48f53f6a6   URL "

Claude: [  +   +  URL ]

** :**

• ID
• ID
• URL (1 )

** :**

: "/Users/me/doc.pdf "
Claude: [    ID ]

MCP Claude :

1. ---

   "report.pdf  2785bbc0e5c281f48dfae9a48f53f6a6   URL "
   "image.png .png   abc123def456 "
   " secret_xxx  .pdf  xyz789  URL "
   

2. ---

   "Notion  secret_abcd1234  /Users/me/doc.pdf "
   " /path/to/image.png logo.png  Notion "
   

3. ** ( )**

   : ".pdf  abc123    "
   Claude: [      ]
   

1. **Notion API **: Notion Integration ()
2. ** **: ()
3. ** ID**: Notion ID ()
4. ****: ()
5. ****: ()

1. **Notion API **: Notion Integration ()
2. ** **: ()
3. ****: (, )

Notion ID

Notion URL ID :

https://www.notion.so/workspace/Page-Title-2785bbc0e5c281f48dfae9a48f53f6a6
                                            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                               ID

(-) :

• 2785bbc0-e5c2-81f4-8dfa-e9a48f53f6a6
• 2785bbc0e5c281f48dfae9a48f53f6a6

Notion API

1. Notion Developers
2. "New integration"
3. Integration
4. "Internal Integration Token"

API

MCP :

1. upload_file_to_notion ( )

ID .

: URL (string)

2. upload_and_attach_file_to_page ( )

• • URL .

: (dict)

{
  "file_upload_id": "2785bbc0-e5c2-81f6-932c-00b265c6d205",
  "file_block_id": "2785bbc0-e5c2-816e-b837-ec0b4298bf29",
  "download_url": "https://prod-files-secure.s3.us-west-2.amazonaws.com/...",
  "expiry_time": "2025-09-24T23:47:33.485Z",
  "filename": "document.pdf",
  "content_type": "application/pdf",
  "file_size": 51290,
  "status": "success",
  "message": "File 'document.pdf' uploaded and attached successfully"
}

• : 20MB
• : , PDF, ,
• ** **: URL 1 ( URL )
• ** **: 1 Notion
• Claude Desktop

1. ---

   • Python/uv

2. ---

   • Notion API
   • 20MB

3. ** ( )**

   • ID ( / )
   • Integration

4. ---

   • Notion Integration
   • Integration

v2.0.0 (Latest)

• ** ** : upload_and_attach_file_to_page

•   +   +  URL 
  

v1.0.0

• : `upload_file_to_notion`
  

• MCP (Model Context Protocol)
• Claude Desktop