Simple Notion MCP Server

@larryhudson

About Simple Notion MCP Server

Notion MCP server that uses Markdown for better LLM support

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "simple-notion-mcp-server": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "npx",
        "tsx",
        "src/index.ts"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Simple Notion MCP Server?

Simple Notion MCP Server is a Model Context Protocol (MCP) server that bridges AI assistants with the Notion API. Unlike the official Notion MCP server, which returns large JSON blobs, this server renders Notion pages as clean Markdown, making them more efficient for LLMs to process and understand.

How to use Simple Notion MCP Server?

Create a Notion integration at https://www.notion.so/my-integrations and obtain an API token. Set the token as the NOTION_TOKEN environment variable or in a .env file. Share any Notion pages you want to access with your integration. Then configure your MCP-compatible application (VS Code, Claude, etc.) to run the server via npx -y @larryhudson/simple-notion-mcp-server with the token. Use the get_page tool with a page_id parameter to retrieve and render a page as Markdown.

Key features of Simple Notion MCP Server

Converts Notion pages to clean, readable Markdown format.
Preserves rich text formatting (bold, italic, strikethrough, code).
Retrieves page metadata and all blocks recursively.
Built with TypeScript, MCP, and the official Notion API Client.

Use cases of Simple Notion MCP Server

AI assistants accessing Notion pages in a LLM-friendly Markdown format.
Integrating Notion documentation into chatbot or summarization workflows.
Quick retrieval of structured page content without parsing raw JSON.

FAQ from Simple Notion MCP Server

How does this differ from the official Notion MCP server?

The official server returns large JSON blobs; this server returns Markdown, which is more efficient for LLMs to process and understand.

What runtime does it require?

It runs via npx (Node.js) and requires a Notion API token. No additional installation is needed beyond Node.js.

Where do my data live?

Data is fetched from the Notion API using your integration token. Pages must be shared with the integration. No data is stored locally.

What are the known limitations?

Currently only supports retrieving pages (not updating or creating). Image handling is basic and may be improved in future updates (e.g. rendering as base64 image blocks).

How do I authenticate?

Set the NOTION_TOKEN environment variable to your Notion integration API token. The server uses this token to authenticate with the Notion API.

Frequently asked questions