Skip to main content
Glama
goonoo

MCP Notion Upload Server

by goonoo
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NOTION_API_TOKENNoYour Notion API token (secret_your_notion_token_here)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Server capabilities have not been inspected yet.

Tools

Functions exposed to the LLM to take actions

NameDescription
upload_file_to_notionA
Upload a file to Notion using the Notion API.

Args:
    file_path: Path to the file to upload
    notion_token: Notion API token for authentication (optional if NOTION_API_TOKEN env var is set)
    file_name: Optional custom filename (defaults to original filename)
    
Returns:
    The file upload ID from Notion (use upload_and_attach_file_to_page for URL)
    
Raises:
    Exception: If file doesn't exist, exceeds size limit, or API call fails
upload_and_attach_file_to_pageA
Upload a file to Notion and attach it to a specific page, returning download URL.

This function performs the complete workflow:
1. Upload file to Notion
2. Create file block and attach to specified page
3. Extract and return download URL with metadata

Args:
    file_path: Path to the file to upload
    page_id: Notion page ID to attach the file to (with or without dashes)
    notion_token: Notion API token for authentication (optional if NOTION_API_TOKEN env var is set)
    file_name: Optional custom filename (defaults to original filename)
    caption: Optional caption for the file block
    
Returns:
    Dictionary containing:
    - file_upload_id: The uploaded file ID
    - file_block_id: The created file block ID
    - download_url: Temporary download URL (expires in 1 hour)
    - expiry_time: ISO timestamp when download URL expires
    - filename: Name of the file
    - content_type: MIME type of the file
    - file_size: Size of the file in bytes
    
Raises:
    Exception: If file doesn't exist, exceeds size limit, or API call fails
    
Example:
    result = await upload_and_attach_file_to_page(
        "document.pdf", 
        "2785bbc0e5c281f48dfae9a48f53f6a6",
        notion_token="ntn_xxx"
    )
    download_url = result["download_url"]

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.9/5.0

Scored across 2 tools

Disambiguation2/5

The two tools have overlapping purposes that could cause confusion. 'upload_and_attach_file_to_page' includes uploading as part of its workflow, while 'upload_file_to_notion' is a standalone upload tool. An agent might struggle to choose between them when they just need to upload a file without attaching it to a page.

Naming Consistency5/5

Both tools follow a consistent snake_case naming pattern with clear verb_noun structure. 'upload_and_attach_file_to_page' and 'upload_file_to_notion' are descriptive and follow the same naming convention throughout.

Tool Count2/5

With only 2 tools, this server feels thin for a Notion integration. A typical Notion MCP server would include more operations like creating pages, retrieving content, updating blocks, or searching databases. The limited tool count suggests incomplete coverage of the domain.

Completeness2/5

The server is severely incomplete for a Notion integration. It only covers file upload operations, missing essential CRUD operations for pages, databases, blocks, and other core Notion resources. There's no way to create, read, update, or delete basic Notion objects beyond file attachments.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources