Better Notion

Name: Better Notion
Author: ai-aviate

by ai-aviatecommunityv0.3.2

better-mcp-notion is an MCP server that allows users to operate Notion using a single Markdown document for reading, creating, and updating pages in one call.

From the registry: Operate Notion with a single Markdown document — read, create, and update pages in one call.

GitHub Repository

Install & configure

Prerequisites

required
Notion integration
Create a Notion integration and share target pages/databases with it.
https://www.notion.so/profile/integrations

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `better-notion` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Notion integration** — Create a Notion integration and share target pages/databases with it. (https://www.notion.so/profile/integrations)

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","better-mcp-notion"]
- required environment variables:
  - `NOTION_API_KEY`: Notion internal integration API key (starts with ntn_) (example: `<your-notion-api-key>`)

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Tools (9)

read

Read a Notion page as Markdown with frontmatter. Supports recursive child page reading with depth.

write

Create or update pages from Markdown. Supports batch operations and append/prepend.

Search the workspace by keyword. Returns a Markdown-formatted list.

list

List database records as a table or child pages as a list. Supports natural language filter & sort.

update

Quick property update without rewriting content. Just pass page + key-value pairs.

schema

View or modify database schema — add, remove, or rename columns.

comment

Add or read comments on a page.

delete

Archive (soft-delete) a page.

move

Move a page to a different parent page or database.

Environment variables

NOTION_API_KEYrequiredAPI key for accessing Notion integration.

Packages

better-mcp-notion

npmv0.3.2transport: stdio

Details

Language: TypeScript
License: NOASSERTION
Released: Feb 19, 2026
Last commit: Feb 19, 2026
Registry name: io.github.ai-aviate/better-notion

Related Servers

Tldraw

Draw and visually collaborate with your agents on tldraw's canvas.

48.8k

Serena

A powerful toolkit for coding, providing semantic retrieval and editing capabilities.

26.5k

Mindwtr

Task and project automation for local Mindwtr data, with read-only self-hosted Cloud access.

1.3k