Easy Notion
by grey-iriscommunityv0.2.3
10
6
Easy Notion MCP is a markdown-first server that connects AI agents to Notion, allowing agents to write markdown which is converted to Notion's block API and back again.
From the registry: Markdown-first Notion MCP server — 92% fewer tokens, 26 tools, round-trip fidelity.
Install & configure
Prerequisites
- requiredNotion integration tokenCreate a Notion integration and share pages with ithttps://www.notion.so/my-integrations
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `easy-notion` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Notion integration token** — Create a Notion integration and share pages with it (https://www.notion.so/my-integrations)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","easy-notion-mcp"]
- required environment variables:
- `NOTION_TOKEN`: Notion API integration token (example: `<your-notion-token>`)
- optional environment variables:
- `NOTION_ROOT_PAGE_ID`: Default parent page ID (example: `<your-root-page-id>`)
- `NOTION_TRUST_CONTENT`: Skip content notice on read_page responses (example: `false`)
Note: Also supports HTTP transport with OAuth via `npx easy-notion-mcp-http`.
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.Note: Also supports HTTP transport with OAuth via `npx easy-notion-mcp-http`.
Tools (17)
create_page
Create a page from markdown
read_page
Read a page as markdown
append_content
Append markdown to a page
replace_content
Replace all content on a page
update_section
Update a section by heading name
find_replace
Find and replace text, preserving files
update_page
Update title, icon, or cover
duplicate_page
Copy a page and its content
archive_page
Move a page to trash
move_page
Move a page to a new parent
restore_page
Restore an archived page
list_pages
List child pages under a parent
search
Search pages and databases
share_page
Get the shareable URL
create_database
Create a database with typed schema
Environment variables
NOTION_OAUTH_CLIENT_IDrequiredOAuth client ID for Notion integrationNOTION_OAUTH_CLIENT_SECRETrequiredOAuth client secret for Notion integrationNOTION_TOKENrequiredAPI token for Notion integrationNOTION_ROOT_PAGE_IDOptional root page ID for creating pagesPackages
easy-notion-mcp
npmv0.2.3transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Mar 26, 2026
- Last commit
- Apr 24, 2026
- Registry name
- io.github.misterwigglesworth/easy-notion