Notion Uploader MCP
Uploads local files (images, documents) to Notion pages as image blocks, file blocks, cover images, or page icons, with optional captions and database property attachment.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Notion Uploader MCP set cover image to cover.png for page abc123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Notion Uploader MCP
Model Context Protocol (MCP) サーバーで、CursorのチャットからNotionページに画像やファイルをアップロードできます。
機能
ローカルファイルをNotionページにアップロード
複数の添付方法をサポート:
image: ページ内に画像ブロックとして追加
file: ページ内にファイルブロックとして追加
cover: ページのカバー画像として設定
icon: ページのアイコンとして設定
データベースプロパティへの添付
大容量ファイルのマルチパートアップロード対応(20MB以上)
キャプション追加機能
Related MCP server: MCP Notion Upload Server
セットアップ
1. Notion APIトークンの取得
Notion Integrations にアクセス
"New integration" をクリック
インテグレーションを作成し、APIトークンをコピー
アップロード先のNotionページにインテグレーションを招待
2. 依存関係のインストール
cd tools/notion-uploader-mcp
npm install3. ビルド
npm run build4. 環境変数の設定
.envファイルを作成し、Notion APIトークンを設定:
cp .env.example .env
# .envファイルを編集してNOTION_TOKENを設定または、環境変数として設定:
export NOTION_TOKEN=secret_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX5. MCP設定への追加
プロジェクトルートの .mcp.json に以下を追加:
{
"mcpServers": {
"notion-uploader": {
"type": "stdio",
"command": "node",
"args": ["./tools/notion-uploader-mcp/dist/server.mjs"],
"env": {
"NOTION_TOKEN": "${NOTION_TOKEN}"
}
}
}
}使用方法
Cursorのチャットで、upload_to_notion ツールが利用可能になります。
パラメータ
file_path(必須): アップロードするファイルの絶対パスpage_id_or_url(必須): NotionページのIDまたはURLattach_as(オプション): 添付方法"image"(デフォルト): 画像ブロックとして追加"file": ファイルブロックとして追加"cover": ページカバーとして設定"icon": ページアイコンとして設定
property(オプション): データベースのファイルプロパティ名caption(オプション): ファイルのキャプション
使用例
# 画像をページに追加
upload_to_notion(
file_path: "/path/to/image.png",
page_id_or_url: "https://notion.so/your-page-id",
caption: "プロジェクトのスクリーンショット"
)
# ページカバーとして設定
upload_to_notion(
file_path: "/path/to/cover.jpg",
page_id_or_url: "your-page-id",
attach_as: "cover"
)
# データベースプロパティに添付
upload_to_notion(
file_path: "/path/to/document.pdf",
page_id_or_url: "database-page-id",
property: "添付ファイル"
)開発
開発モード
TypeScriptファイルを直接実行:
npm run devビルド
TypeScriptをJavaScriptにコンパイル:
npm run buildトラブルシューティング
NOTION_TOKEN not found: 環境変数が正しく設定されているか確認
Page not found: ページIDが正しいか、インテグレーションが招待されているか確認
Permission denied: インテグレーションに適切な権限があるか確認
ライセンス
プロジェクトのライセンスに従います。
Available Tools
2 toolsupload_to_notionC
Upload a local file to Notion and attach it to a page
Inputs: file_path (required), page_id_or_url (required), caption, property, +1 more.
upload_to_notion_atB
Upload a file and insert an image/file block immediately AFTER a placeholder or a specific block_id
Inputs: file_path (required), page_id_or_url (required), caption, block_id, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
Both tools perform uploads to Notion, differing only in placement: one attaches to a page generically, the other inserts after a specific block. The names are very similar, so an agent could easily pick the wrong one without reading carefully, though the descriptions do clarify the distinction.
Both tool names follow the same verb_noun pattern, 'upload_to_notion', with the second adding a consistent '_at' suffix to indicate location specificity. This is a predictable and uniform convention.
With only two tools, the server feels borderline thin for its stated purpose, though each tool does cover a distinct aspect of uploading. It is not egregiously sparse, but a more complete server might include additional related operations.
The server covers the core upload functionality for its narrow domain: basic page attachment and targeted insertion after a block. Minor gaps exist, such as lacking an explicit way to specify a page for the general upload or support for deleting/replacing uploaded blocks, but agents can likely accomplish common tasks with these two tools.
Maintenance
Related MCP Connectors
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
Send files and manage client uploads from a compatible AI agent.
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
Long-term memory for Claude, ChatGPT, Cursor: search, save and organize notes, links, docs, videos.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Notion workspaces through the Notion API. Supports creating, retrieving, and updating Notion pages and their properties, allowing users to manage Notion content through natural language.4MIT
- FlicenseAqualityDmaintenanceEnables uploading files to Notion with complete workflow support including file upload, automatic page attachment, and download URL generation. Supports files up to 20MB with custom naming and metadata handling.21-
- AlicenseNot gradedqualityDmaintenanceEnables Claude Desktop to read and create Notion pages with markdown formatting support.MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Notion databases and pages via the Notion API. Allows searching, reading, and writing to Notion through natural language.MIT