Claude Desktop Notion MCP Server

What is Claude Desktop Notion MCP Server?

It is a filesystem Model Context Protocol (MCP) server for Claude Desktop that enables Claude to read, write, and manipulate files on your system. It is built with Bun and includes secure path normalization.

How to use Claude Desktop Notion MCP Server?

Clone the repository, run bun install, then configure Claude Desktop by adding the server to claude_desktop_config.json with the Bun command and your Notion integration key as an argument. Optionally, provide a base directory; otherwise the current working directory is used.

Key features of Claude Desktop Notion MCP Server

• List files with glob pattern matching
• Read file contents
• Write content to files
• Edit files and display diff output
• Delete files with secure path normalization

Use cases of Claude Desktop Notion MCP Server

• Allow Claude to read configuration or log files
• Let Claude write or edit project files during a conversation
• Automate file deletion or cleanup tasks
• Preview changes via diff before applying edits

FAQ from Claude Desktop Notion MCP Server

What runtime is required?

Bun v1.2.5 or later.

How do I install the server?

Clone the repository and run bun install to install dependencies.

How do I configure Claude Desktop to use this server?

Add an entry to claude_desktop_config.json with the command set to bun, args including run <path>/src/notion/index.ts and your Notion integration key.

What security measures are implemented?

Path normalization and validation ensure operations are restricted to the specified base directory, preventing directory traversal attacks.

What tools does the server expose?

list_files, read_file, write_file, edit_file, and delete_file.