Better Notion

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/ai-aviate-better-notion

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

4 read · 4 write · 1 delete

Secrets

1 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Node.js package

Tools (9)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• comment

  Add or read comments on a Notion page. ## Read comments comment({ page: "abc123" }) Returns all comments on the page as a Markdown list. ## Add a comment comment({ page: "abc123", body: "Looks good! Ready to ship." }) Adds a comment to the page. You can use the page name, ID, or URL.

• delete

  Archive (soft-delete) a Notion page. The page is moved to Trash and can be restored from Notion's UI. This does NOT permanently delete the page.

• list

  List database records as a Markdown table, or list child pages of a page. For databases: returns a table with properties as columns. For pages: returns a numbered list of child pages. You can pass a database/page name (resolved via search) or an ID/URL. ## Filter syntax (databases only) Simple expressions matched against DB property names and types: - "Status is Done" → select/status equals - "Priority = High" → select equals - "Tags contains backend" → multi_select contains - "Done is true" → checkbox equals - "Due Date after 2026-03-01" → date after - "Score > 80" → number greater_than - …

• move

  Move a Notion page to a different parent page or database. The page keeps its content and properties; only the location changes. Example: move a page into an "Archive" page, or move a task into a different database.

• read

  Read a Notion page and return it as Markdown with YAML frontmatter. Returns frontmatter fields: - id, url: page identifiers - title: page title - parent / database: parent page ID or database ID - icon, cover: emoji or image URL - properties: database properties (if the page belongs to a database) - created, last_edited: timestamps (read-only) The body contains the page content as standard Markdown. The output can be edited and passed directly to the "write" tool to update the page. Use "depth" to include child pages in a single call (default: 1 = current page only, 2 = include children, 3…

• schema

  View or modify database schema (columns/properties). ## Actions ### "list" (default) — View current schema schema({ database: "Task Board" }) Returns: property names, types, and select/multi_select options. ### "add" — Add a new property schema({ database: "Task Board", action: "add", property: "Priority", type: "select", options: ["Low", "Medium", "High"] }) ### "remove" — Remove a property schema({ database: "Task Board", action: "remove", property: "Old Column" }) ### "rename" — Rename a property schema({ database: "Task Board", action: "rename", property: "Due", name: "Due D…

• search

  Search the Notion workspace by title keyword. Returns a Markdown list with page/database IDs, titles, and metadata. Use the returned IDs with other tools: read (to get full content), write (to update), list (to query a database), delete, or move. Example output: # Search results: "MCP" (2 results) 1. **MCP Design Doc** (📝 page) - ID: `abc123` - Last edited: 2026-02-19 2. **Task Board** (database) - ID: `def456`

• update

  Quickly update page properties without rewriting content. Much simpler than the write tool for property-only changes. The page content (blocks) is never touched — only properties are updated. ## Parameters - page: Page ID, URL, or name - properties: Key-value object of properties to set ## Examples Update a single property: update({ page: "abc123", properties: { "Status": "Done" } }) Update multiple properties: update({ page: "My Task", properties: { "Status": "Done", "Priority": "High", "Due Date": "2026-03-01" } }) Supported value types: - Text: "value" - Number: 42 - Checkbox: tru…

• write

  Create or update Notion pages from Markdown with YAML frontmatter. Mode (default "auto"): if frontmatter has "id" → update, otherwise → create. ## Batch mode Separate multiple pages with a line containing only "===" to create/update them in one call. ## Frontmatter fields | Field | Create | Update | Description | |-------|--------|--------|-------------| | id | - | required | Page ID to update | | title | recommended | optional | Page title | | parent | required* | ignored | Parent page name or ID | | database | required* | ignored | Database name or ID (*either parent or database) | | ico…

Signals

Stars

2

Forks

0

Open issues

1

Last commit

Feb 19, 2026 (8 months ago)

Last release

Feb 19, 2026 (8 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.ai-aviate/better-notion

Version

0.3.2

Auth

API key

Packages

npm better-mcp-notion

License

License unknown

Repository

github.com/ai-aviate/better-mcp-notion

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql