Skip to content

easy-notion-mcp

MIT★ 55updated 11 Sept 2026

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.

Tools (43)

create_pageCreate a page from markdown
create_page_from_fileCreate a page from a local markdown file (stdio only)
read_pageRead a page as markdown
read_sectionRead one section by heading name
read_blockRead one block by ID, including nested children for containers
read_toggleRead one toggle or toggleable heading by title
search_in_pageSearch raw block text in a page or one toggle
append_contentAppend markdown to a page
replace_contentReplace all page content atomically (preserves block IDs of matched blocks)
update_sectionUpdate a section by heading name; optional heading-preserving body replacement (destructive; duplicate_page first for irreplaceable content)
update_toggleUpdate one toggle body by title (destructive; preserves the toggle container ID)
archive_toggleArchive one toggle or toggleable heading by title
restore_toggleRestore an archived toggle or toggleable heading by archived block ID
find_replaceFind and replace text, preserving files
update_blockUpdate a single block by ID (preserves block identity for deep links and comments)
update_pageUpdate title, icon, or cover
duplicate_pageCopy a page and its content
archive_pageMove a page to trash
move_pageMove a page to a new parent
restore_pageRestore an archived page
list_pagesList child pages under a parent, with createdtime and lasteditedtime` per row
share_pageGet the shareable URL
create_databaseCreate a database with typed schema
update_data_sourceUpdate database schema (add, rename, or remove properties; change title; trash or restore)
get_databaseGet database schema, property names, and options
list_databasesList all databases the integration can access
query_databaseQuery with filters, sorts, or text search
add_database_entryAdd a row using simple key-value pairs
add_database_entriesAdd multiple rows in one call
update_database_entryUpdate a row using simple key-value pairs
delete_database_entryDelete (archive) a database entry
list_viewsList saved views for a database or data source
get_viewGet one saved view's raw configuration
query_viewQuery entries through a saved view
create_viewCreate a table, list, board, calendar, gallery, or timeline view
update_viewRename or update a saved view's raw filter/sort/configuration fields
delete_viewDelete a saved view with explicit confirmation
list_commentsList comments on a page
add_commentAdd a comment to a page
list_usersList workspace users
get_meGet the current bot user
get_configReport the server's own settings: version, transport, workspace root, and visible tool count
searchSearch pages and databases

Tool names from the README, checked 16 Nov 2026.

easy-notion-mcp compared with other Notion servers

ServerLicenceToolsLast commitStars
easy-notion-mcpMIT4311 Sept 202655
notionApache-2.01014 Nov 202636
Notion Large File UploadMIT328 Oct 202613

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.

More Notion MCP servers