Easy Notion
Connects Claude to Notion through a markdown translation layer instead of raw JSON blocks. You get 42 tools covering page creation, database queries, content updates, and file uploads, all working with GitHub-flavored markdown rather than Notion's block API. The server claims 92% token reduction compared to the official Notion MCP by avoiding verbose JSON serialization. Supports 24 block types including toggles, columns, callouts, and tables with round-trip fidelity, meaning you can read a page as markdown, modify it, and write it back without losing formatting. Ships with CLI profiles for separating readonly and write operations across different integrations. Useful when you want agents editing Notion documents without teaching them Notion's nested block structure.
- GitHub stars
- 55
- tools
- 43
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Aug 28, 2026
Tools
43 toolsPublic tool metadata for what this MCP can expose to an agent.
create_pageCreate a page from markdown
Create a page from markdown
No parameter schema in public metadata yet.
create_page_from_fileCreate a page from a local markdown file (stdio only)
Create a page from a local markdown file (stdio only)
No parameter schema in public metadata yet.
read_pageRead a page as markdown
Read a page as markdown
No parameter schema in public metadata yet.
read_sectionRead one section by heading name
Read one section by heading name
No parameter schema in public metadata yet.
read_blockRead one block by ID, including nested children for containers
Read one block by ID, including nested children for containers
No parameter schema in public metadata yet.
read_toggleRead one toggle or toggleable heading by title
Read one toggle or toggleable heading by title
No parameter schema in public metadata yet.
search_in_pageSearch raw block text in a page or one toggle
Search raw block text in a page or one toggle
No parameter schema in public metadata yet.
append_contentAppend markdown to a page
Append markdown to a page
No parameter schema in public metadata yet.
replace_contentReplace all page content atomically (preserves block IDs of matched blocks)
Replace all page content atomically (preserves block IDs of matched blocks)
No parameter schema in public metadata yet.
update_sectionUpdate a section by heading name; optional heading-preserving body replacement (destructive; duplicate_page first for irreplaceable content)
Update a section by heading name; optional heading-preserving body replacement (destructive; duplicate_page first for irreplaceable content)
No parameter schema in public metadata yet.
update_toggleUpdate one toggle body by title (destructive; preserves the toggle container ID)
Update one toggle body by title (destructive; preserves the toggle container ID)
No parameter schema in public metadata yet.
archive_toggleArchive one toggle or toggleable heading by title
Archive one toggle or toggleable heading by title
No parameter schema in public metadata yet.
restore_toggleRestore an archived toggle or toggleable heading by archived block ID
Restore an archived toggle or toggleable heading by archived block ID
No parameter schema in public metadata yet.
find_replaceFind and replace text, preserving files
Find and replace text, preserving files
No parameter schema in public metadata yet.
update_blockUpdate a single block by ID (preserves block identity for deep links and comments)
Update a single block by ID (preserves block identity for deep links and comments)
No parameter schema in public metadata yet.
update_pageUpdate title, icon, or cover
Update title, icon, or cover
No parameter schema in public metadata yet.
duplicate_pageCopy a page and its content
Copy a page and its content
No parameter schema in public metadata yet.
archive_pageMove a page to trash
Move a page to trash
No parameter schema in public metadata yet.
move_pageMove a page to a new parent
Move a page to a new parent
No parameter schema in public metadata yet.
restore_pageRestore an archived page
Restore an archived page
No parameter schema in public metadata yet.
list_pagesList child pages under a parent, with created_time and last_edited_time per row
List child pages under a parent, with created_time and last_edited_time per row
No parameter schema in public metadata yet.
searchSearch pages and databases
Search pages and databases
No parameter schema in public metadata yet.
share_pageGet the shareable URL
Get the shareable URL
No parameter schema in public metadata yet.
create_databaseCreate a database with typed schema
Create a database with typed schema
No parameter schema in public metadata yet.
update_data_sourceUpdate database schema (add, rename, or remove properties; change title; trash or restore)
Update database schema (add, rename, or remove properties; change title; trash or restore)
No parameter schema in public metadata yet.
get_databaseGet database schema, property names, and options
Get database schema, property names, and options
No parameter schema in public metadata yet.
list_databasesList all databases the integration can access
List all databases the integration can access
No parameter schema in public metadata yet.
query_databaseQuery with filters, sorts, or text search
Query with filters, sorts, or text search
No parameter schema in public metadata yet.
add_database_entryAdd a row using simple key-value pairs
Add a row using simple key-value pairs
No parameter schema in public metadata yet.
add_database_entriesAdd multiple rows in one call
Add multiple rows in one call
No parameter schema in public metadata yet.
update_database_entryUpdate a row using simple key-value pairs
Update a row using simple key-value pairs
No parameter schema in public metadata yet.
delete_database_entryDelete (archive) a database entry
Delete (archive) a database entry
No parameter schema in public metadata yet.
list_viewsList saved views for a database or data source
List saved views for a database or data source
No parameter schema in public metadata yet.
get_viewGet one saved view's raw configuration
Get one saved view's raw configuration
No parameter schema in public metadata yet.
query_viewQuery entries through a saved view
Query entries through a saved view
No parameter schema in public metadata yet.
create_viewCreate a table, list, board, calendar, gallery, or timeline view
Create a table, list, board, calendar, gallery, or timeline view
No parameter schema in public metadata yet.
update_viewRename or update a saved view's raw filter/sort/configuration fields
Rename or update a saved view's raw filter/sort/configuration fields
No parameter schema in public metadata yet.
delete_viewDelete a saved view with explicit confirmation
Delete a saved view with explicit confirmation
No parameter schema in public metadata yet.
list_commentsList comments on a page
List comments on a page
No parameter schema in public metadata yet.
add_commentAdd a comment to a page
Add a comment to a page
No parameter schema in public metadata yet.
list_usersList workspace users
List workspace users
No parameter schema in public metadata yet.
get_meGet the current bot user
Get the current bot user
No parameter schema in public metadata yet.
get_configReport the server's own settings: version, transport, workspace root, and visible tool count
Report the server's own settings: version, transport, workspace root, and visible tool count
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
NOTION_TOKEN*secretNotion integration token
NOTION_ROOT_PAGE_IDDefault parent page ID for create_page (optional — falls back to workspace root in OAuth mode)
Readme
Easy Notion MCP
Markdown-first MCP server that connects AI agents to Notion.
Agents write markdown — easy-notion-mcp converts it to Notion's block API and back again.
43 tools · 24 block types · ~6–7× fewer response tokens vs official Notion MCP · Documented round-trip support
npx easy-notion-mcp
See it in action → Live Notion page created and managed entirely through easy-notion-mcp.
Raw JSON chaos vs clean markdown
Details
- Repository
- github.com/grey-iris/easy-notion-mcp
- Category
- Documents & Knowledge
- Package
easy-notion-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
Related Documents & Knowledge MCP servers
View all
Notionn24q02m/notionMarkdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.36stars
Zotero Bridgecombjellyshen/zoterobridgeMCP Server for Zotero SQLite Database - collection, tagging, PDF reading and more.10stars
Pdf Itmrslbt/pdf-itNative PDF renderer for AI markdown. Cover, TOC, page-numbered footer. Fonts embedded, zero config.2stars
Notion Mcpshck-dev/notion-mcpNotion MCP server — search, export, and import pages as markdown2stars
Slipstack PDFdev.slipstack/pdfGenerate invoice and receipt PDFs from JSON. Agent-callable document API with a free demo quota.0stars
PDF Generator APIbr0ski777/pdf-generator-x402Generate PDF from HTML or Markdown with custom pages, margins, layout. x402.0stars