mcpField
B
Browse your entire Notion workspace, not just one database

Browse your entire Notion workspace, not just one database

Local
github.com/seonglaeMemory & Knowledge8Updated 84w ago
Repository

About Browse your entire Notion workspace, not just one database

This TypeScript MCP server uses ROOT_PAGE to navigate a Notion workspace, converts pages to Markdown, and finds content through page relationships. It is intended for working with and browsing Notion notes.

Key features

  1. 01Set the entry page with ROOT_PAGE
  2. 02Expose Notion pages as Markdown resources
  3. 03Search notes with a query
  4. 04Find pages via parent, child, and reference links
  5. 05Offer prompts for summaries and content improvements

Use cases

  1. 01Browse Notion pages across a workspace
  2. 02Search for and read relevant notes
  3. 03Summarize a selected page
  4. 04Get suggestions for note structure and content

MCP support

The MCP server provides Notion page resources, a search tool, and prompts for summarization and improvement. It supports stdio and remote SSE communication.

#mcp#notion#notion-api#prompt-engineering#anthropic#model-context-protocol#context-protocol#ai-protocol

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "supergateway"
      ]
    }
  }
}
Run commandnpx -y supergateway

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmsupergateway

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Browse your entire Notion workspace, not just one database

Markdown based Notion navigating MCP with just a single ROOT_PAGE variable, eliminating the need for a token.

  • Notion MCP Server: notion-texonom
  • Notion pages are converted into text/markdown mimeType notes.
  • Search and retrieve relevant pages based on graph distance, considering parent-child and reference relationships.

A Model Context Protocol (MCP) server for managing and interacting with Notion-based notes. This TypeScript-based server demonstrates MCP concepts by integrating resources, tools, and prompts to interact with Notion pages efficiently.

Features

Resources
Resources Inspection
  • Access Notes: List and retrieve Notion pages as note:// URIs with UUID slugs.
  • Metadata: Each resource includes a title, description, and content in Markdown format.
  • Mime Types: Content is accessible in text/markdown format.
Tools
Tools Inspection
  • Search Notes: Use the search_notes tool to search for Notion pages using a query string.
    • Input: Query text to filter relevant pages.
    • Output: Markdown content of matching notes.
Prompts
Prompts Inspection
  • Summarize Notes: Generate summaries for individual Notion pages.
    • Available Prompts:
      • summarize_note: Summarize a specific note by URI.
      • suggest_refactor: Propose structural improvements.
      • suggest_fix: Identify potential fixes for note content.
      • suggest_enhance: Recommend enhancements to improve the note.
    • Input: Notion page URI.
    • Output: Structured messages for summarization and enhancement.

Development

Setup

Install dependencies:

pnpm install

Build the project:

pnpm build

For development with auto-rebuild:

pnpm watch

Configuration

To configure the server with Notion:

  • Set environment variables:
    • ROOT_PAGE: The root page ID of your Notion workspace.

Installation for Claude Desktop

To use this server with Claude Desktop, add the configuration:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

Example configuration:

{
  "mcpServers": {
    "notion-texonom": {
      "command": "node",
      "args": [
        "/path/to/mcp/build/index.js"
      ],
      "env": {
        "ROOT_PAGE": "$SOME_UUID"
      }
    }
  }
}
Debugging

For troubleshooting and debugging the MCP server, use the MCP Inspector. To start the Inspector, run:

pnpm inspector

The Inspector provides a browser-based interface for inspecting stdio-based server communication.

Key Technologies

  • Notion Integration: Powered by @texonom/nclient and @texonom/cli.
  • MCP SDK: Implements @modelcontextprotocol/sdk for server operations.

Remote Deployment

The server now uses SSEServerTransport for remote communication, enabling shared usage of the server. Ensure that the necessary dependencies are installed and the server is configured correctly for remote deployment.

Usage Instructions

To run the server with SSEServerTransport, use the following command:

npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem /some/folder"

Make sure to replace /some/folder with the appropriate path to your folder.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.