Notion

MCP server for reading and writing Notion pages and databases. Search across your workspace, read page content, create new pages, update database properties, and query database views. Uses Notion API key authentication with configurable access scope.

Useful for managing project trackers, updating wiki pages, querying task databases, creating meeting notes, syncing data into Notion tables, and any workflow that uses Notion as a knowledge base or project management tool.

Install

amodal install mcp notion

Tools exposed

• search — Full-text search across all pages and databases the integration can access. Returns page ID, title, parent, last edited time, and a content snippet. Supports filtering by object type (page or database).
• read_page — Read the full content of a Notion page as structured blocks: headings, paragraphs, lists, code blocks, tables, callouts, and embeds. Returns content in a readable format.
• query_database — Query a Notion database with filters and sorts. Supports filtering by any property type (text, number, select, date, checkbox, relation). Returns rows as structured property maps.
• create_page — Create a new page in a database or as a child of another page (confirmation required). Supports setting properties and initial content blocks.
• update_page_properties — Update properties on an existing database page: status, assignee, due date, tags, or any custom property (confirmation required).
• append_blocks — Append content blocks to an existing page: paragraphs, headings, lists, code blocks, dividers, and callouts (confirmation required).
• list_databases — List all databases the integration can access with their property schemas.

Configuration

env:
  NOTION_API_KEY: "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

• NOTION_API_KEY — Notion internal integration token. Create one at https://www.notion.so/my-integrations. The integration must be added to specific pages/databases to grant access. Required.

Example usage

• "Search Notion for our incident response procedures"
• "Query the sprint board for all tasks assigned to me that are in progress"
• "Create a new page in the Meeting Notes database with today's standup summary"
• "Update the status of ticket PROJ-142 to Done and set the completion date to today"