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
| Task | notion | Notion MCP | ntn | notion-mcp-server | notion-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 | ✅ | ✅ | ✅ | 🟡 | ❌ |
| Requirement | notion | Notion MCP | ntn | notion-mcp-server | notion-exporter |
|---|---|---|---|---|---|
| Install | npm, Node 22.16 or a later 22.x, or Node 24 or later | nothing: your AI app connects to Notion's server | install script, WinGet or npm | npx or Docker | npm |
| Licence | Apache-2.0 | a Notion service, on every plan | MIT | MIT | MIT |
| Sign in | a personal access token or a connection's token, kept in the keyring | OAuth in the browser, or an MCP token on Business and Enterprise | in the browser, or a personal access token | a connection's token | the token_v2 and file_token cookies of your browser |
Notes on the marks:
- Find a page by words.
notion searchsearches the copy on your computer, in the text of each page and row. Notion's API search, whichntn api v1/searchand notion-mcp-server call, finds pages by their title. Notion MCP runs Notion's own workspace search. - By meaning.
notion sync --embedindexes the text with a model already downloaded to your computer, and thennotion searchfinds 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 searchandmemo search allfind 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.
notionkeeps each row's properties in the copy as lines such asStatus: Done, sonotion searchfinds them as words, not as a field. A filter on a property works today only through the raw API commandnotion <profile> api post-database-query, with a JSON body. A ready search by property, such asstatus: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 synccopies 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 exportwrites one page from the copy to a Markdown file.ntn pages getprints 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.notionplans one. - Write.
notionhas no ready command to write a page yet. Its raw API commands, such asapi post-pageandapi 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
permissionssetting gives a command the levelreadonlyordeny, andWCNOTION_READ_ONLY=1refuses every write. By default the MCP server offers the writes too, and over MCP anasklevel 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-runshows 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
notionMCP 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.