Notion

Compared with other tools — Notion

Compare the Notion CLI with Notion's own MCP server and other tools that give Notion to an agent.

notion is a command line and an MCP server that keeps a copy of your Notion pages and databases on your computer, searches it offline and gives it to your AI agent. This page puts it next to the other tools people use to let an agent or a script read and change Notion, so you can see which one fits your job. The marks for notion come from version 0.2.0, and the marks for the other tools from their own documentation and source, all checked on 16 November 2026. A tool may do more than its pages say.

The tools:

  • notion: this tool. Signs in with your own Notion token, copies the pages and databases you choose to your computer, finds them by words and by meaning, and gives them to an agent in the terminal or over MCP. It is in development: ready commands to write pages, a search by a database property and a Markdown folder kept in step with Notion are not there yet.
  • Notion MCP: Notion's own MCP server, hosted by Notion. Your AI app connects to it and signs in to your workspace.
  • ntn: Notion's own command line. It reads and writes pages as Markdown, queries databases, uploads files and manages Notion Workers.
  • notion-mcp-server: Notion's open source MCP server, which you run yourself with a token. Its README says it is no longer actively maintained.
  • notion-exporter: a command line that downloads a page or a database as Markdown or CSV files through the export of Notion's web app (193 stars, updated 23 October 2026).

✅ yes · 🟡 partly · ❌ no · ➖ not in its documentation · n/a does not apply

Features

TasknotionNotion MCPntnnotion-mcp-servernotion-exporter
Find a page
Find a page by words inside it✅✅❌🟡❌
Find a page by meaning, not only by exact words✅✅❌❌❌
Search your pages with no internet✅❌❌❌❌
Find a page together with your chats, mail and files from other services✅🟡❌❌❌
Find database rows by a property value, such as Status is Done🟡✅✅✅❌
Keep a copy and export
Keep a copy of chosen pages and databases on your computer, updated by each sync✅➖❌➖🟡
Export a page and the pages under it as Markdown files🟡➖🟡➖✅
Write
Create a page or change its text from Markdown🟡✅✅🟡❌
Agents and safety
An AI app works with your pages over MCP✅✅❌✅❌
Use it from Claude or ChatGPT on the web✅✅❌🟡❌
An agent with a terminal runs it, with JSON output and a skill✅n/a🟡n/a❌
An agent can be limited to reading✅🟡➖✅✅
Allow or deny single commands for an agent✅➖➖➖n/a
Preview a change before it is made✅🟡➖➖n/a
Text from a page reaches the agent as data, never as instructions🟡➖➖➖➖
Setup
Works with an agent that has no browser✅🟡✅✅🟡
Relies only on what Notion documents and supports✅✅✅🟡❌
RequirementnotionNotion MCPntnnotion-mcp-servernotion-exporter
Installnpm, Node 22.16 or a later 22.x, or Node 24 or laternothing: your AI app connects to Notion's serverinstall script, WinGet or npmnpx or Dockernpm
LicenceApache-2.0a Notion service, on every planMITMITMIT
Sign ina personal access token or a connection's token, kept in the keyringOAuth in the browser, or an MCP token on Business and Enterprisein the browser, or a personal access tokena connection's tokenthe token_v2 and file_token cookies of your browser

Notes on the marks:

  • Find a page by words. notion search searches the copy on your computer, in the text of each page and row. Notion's API search, which ntn api v1/search and notion-mcp-server call, finds pages by their title. Notion MCP runs Notion's own workspace search.
  • By meaning. notion sync --embed indexes the text with a model already downloaded to your computer, and then notion search finds a page by its meaning too. Notion MCP searches by meaning on Notion's side.
  • With your chats and mail. The copy is in the local store every WireCat tool shares, so memo search and memo search all find a page next to your messages, mail and files from the other WireCat tools. Notion MCP searches connected services such as Slack and Google Drive on the Business and Enterprise plans with Notion AI.
  • Database rows by property. notion keeps each row's properties in the copy as lines such as Status: Done, so notion search finds them as words, not as a field. A filter on a property works today only through the raw API command notion <profile> api post-database-query, with a JSON body. A ready search by property, such as status:Done, is planned. On Notion MCP a query by property shares a limited allowance per workspace below the Business plan with Notion AI.
  • A copy on your computer. notion sync copies the chosen pages, the pages under them, databases and their rows, and each next sync takes only what changed. notion-exporter downloads a page tree once (-r <folder>) and keeps no record of what changed.
  • Export. notion documents export writes one page from the copy to a Markdown file. ntn pages get prints one page as Markdown. notion-exporter writes the whole page tree, and a database as a CSV file. No tool here keeps a folder of Markdown files in step with Notion both ways. notion plans one.
  • Write. notion has no ready command to write a page yet. Its raw API commands, such as api post-page and api update-page-markdown, create a page and change its Markdown, and an agent writes the JSON body itself. Each one has its own permission and --dry-run. notion-mcp-server writes the same way, through tools made from Notion's API.
  • Limited to reading. The permissions setting gives a command the level readonly or deny, and WCNOTION_READ_ONLY=1 refuses every write. By default the MCP server offers the writes too, and over MCP an ask level lets a command run. See settings. notion-mcp-server reads only with a token that has only the "Read content" capability. On Notion MCP, turning off editing in MCP clients and blocking AI apps that are not approved are both admin controls of MCP Governance, on the Enterprise plan only.
  • Preview. --dry-run shows what a command would do and sends nothing. Notion MCP can propose a page edit that someone reviews before it applies, on the Business and Enterprise plans.
  • Text as data. The notion MCP server tells the agent that page text, titles and property names come from other people and are data, never instructions. The text itself is not marked inside each answer.
  • No browser. Notion MCP takes a token without a browser only when a workspace owner on the Business or Enterprise plan creates one. notion-exporter needs two cookies copied by hand from a browser where you are signed in.
  • What Notion supports. notion-exporter uses the export of Notion's web app, an internal API that its README says "may break anytime". notion-mcp-server calls the public API, but Notion no longer maintains it.

When another tool fits better

  • Notion MCP: you want Claude or ChatGPT to search, write and organise your workspace with nothing to install, and your pages do not need to be on your computer.
  • ntn: you want ready commands to create and edit pages from Markdown in a script today, or you build Notion Workers.
  • notion-exporter: you want a page tree or a database as Markdown and CSV files once, such as for a static site or a backup.

If notion fits, start with installation.