easy-notion-mcp
Markdown-first Notion MCP server. ~6-7x fewer response tokens vs official Notion MCP. 43 tools.
What can you do with easy-notion-mcp?
- create_page — Create a page from markdown
- create_page_from_file — Create a page from a local markdown file (stdio only)
- read_page — Read a page as markdown
- read_section — Read one section by heading name
- read_block — Read one block by ID, including nested children for containers
- read_toggle — Read one toggle or toggleable heading by title
Tool descriptions from the project's README, checked 16 Nov 2026.
About 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
Opening text of the project's README, checked 16 Nov 2026.
Install
{
"mcpServers": {
"easy-notion": {
"command": "npx",
"args": [
"-y",
"easy-notion-mcp"
],
"env": {
"NOTION_TOKEN": "<your NOTION_TOKEN>"
}
}
}
}Config as documented in its source, checked 16 Nov 2026. Placeholders such as API keys are the project's own: replace them with your values.
Setup documented for
Tools (43)
| create_page | Create a page from markdown |
| create_page_from_file | Create a page from a local markdown file (stdio only) |
| read_page | Read a page as markdown |
| read_section | Read one section by heading name |
| read_block | Read one block by ID, including nested children for containers |
| read_toggle | Read one toggle or toggleable heading by title |
| search_in_page | Search raw block text in a page or one toggle |
| append_content | Append markdown to a page |
| replace_content | Replace all page content atomically (preserves block IDs of matched blocks) |
| update_section | Update a section by heading name; optional heading-preserving body replacement (destructive; duplicate_page first for irreplaceable content) |
| update_toggle | Update one toggle body by title (destructive; preserves the toggle container ID) |
| archive_toggle | Archive one toggle or toggleable heading by title |
| restore_toggle | Restore an archived toggle or toggleable heading by archived block ID |
| find_replace | Find and replace text, preserving files |
| update_block | Update a single block by ID (preserves block identity for deep links and comments) |
| 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, with createdtime and lasteditedtime` per row |
| share_page | Get the shareable URL |
| create_database | Create a database with typed schema |
| update_data_source | Update database schema (add, rename, or remove properties; change title; trash or restore) |
| get_database | Get database schema, property names, and options |
| list_databases | List all databases the integration can access |
| query_database | Query with filters, sorts, or text search |
| add_database_entry | Add a row using simple key-value pairs |
| add_database_entries | Add multiple rows in one call |
| update_database_entry | Update a row using simple key-value pairs |
| delete_database_entry | Delete (archive) a database entry |
| list_views | List saved views for a database or data source |
| get_view | Get one saved view's raw configuration |
| query_view | Query entries through a saved view |
| create_view | Create a table, list, board, calendar, gallery, or timeline view |
| update_view | Rename or update a saved view's raw filter/sort/configuration fields |
| delete_view | Delete a saved view with explicit confirmation |
| list_comments | List comments on a page |
| add_comment | Add a comment to a page |
| list_users | List workspace users |
| get_me | Get the current bot user |
| get_config | Report the server's own settings: version, transport, workspace root, and visible tool count |
| search | Search pages and databases |
Tool names from the README, checked 16 Nov 2026.
easy-notion-mcp compared with other Notion servers
| Server | Licence | Tools | Last commit | Stars |
|---|---|---|---|---|
| easy-notion-mcp | MIT | 43 | 11 Sept 2026 | 55 |
| notion | Apache-2.0 | 10 | 14 Nov 2026 | 36 |
| Notion Large File Upload | MIT | 3 | 28 Oct 2026 | 13 |
Every value is a checked fact on that server's own page. This is a comparison of facts, not a ranking.
Verified facts
- Maintainer
- Grey-Iris
Source · checked 16 Nov 2026
- Licence
- MIT
Source · checked 16 Nov 2026
- Transport
- stdio
Source · checked 16 Nov 2026
- Required settings
- Environment variables: NOTION_TOKEN
Source · checked 16 Nov 2026
- Setup documented for
- Claude Code
- Claude Desktop
- Cursor
- VS Code
- Windsurf
Source · checked 16 Nov 2026
- Repository
- github.com/Grey-Iris/easy-notion-mcp
Source · checked 16 Nov 2026
- Package
- easy-notion-mcp (npm)
Source · checked 16 Nov 2026
- Latest version
- 1.1.0
Source · checked 16 Nov 2026
- Last commit
- 11 Sept 2026
Source · checked 16 Nov 2026
- GitHub stars
- 55
Source · checked 16 Nov 2026
- Open issues
- 4
Source · checked 16 Nov 2026
Each value links to where it was found and shows the date it was checked. How we verify
Frequently asked questions
What does easy-notion-mcp do?
Markdown-first Notion MCP server. ~6-7x fewer response tokens vs official Notion MCP. 43 tools.
Which MCP clients does easy-notion-mcp document setup for?
Its README documents setup for Claude Code, Claude Desktop, Cursor, VS Code, Windsurf.
How do I install easy-notion-mcp?
Add the install config shown on this page to your MCP client's configuration; the package is easy-notion-mcp (npm). Check the README for client-specific steps.
What licence is easy-notion-mcp under?
MIT, as reported by the repository on 16 Nov 2026.
Is easy-notion-mcp still maintained?
The last commit was on 11 Sept 2026, and the repository had 4 open issues.
What settings does easy-notion-mcp need?
Environment variables: NOTION_TOKEN.
What tools does easy-notion-mcp expose?
43 tools: create_page, create_page_from_file, read_page, read_section, read_block, read_toggle, search_in_page, append_content, replace_content, update_section, update_toggle, archive_toggle, and more.
