Notion MCP Server

Notion

Notion is a workspace platform for docs, databases, and project management. This bundle provides access to pages, databases, views, comments, users, and cross-source search.

Entity Hierarchy

• Workspace is the top-level boundary. All content belongs to a workspace.
• Teams (teamspaces) organize members and content within a workspace.
• Pages are individual documents with rich content (text, media, embeds, nested pages).
• Databases are structured collections of pages with typed properties (select, date, relation, formula).
• Data Sources are the underlying schema and storage for databases. A database can have multiple data sources.
• Views define how database content is displayed (table, board, calendar, timeline, gallery, chart, form, map, dashboard).
• Comments are discussions attached to pages or specific content blocks, supporting threads and replies.

Capabilities

Search and retrieval:

• Search across the Notion workspace by keyword or phrase
• Search connected sources (Slack, Google Drive, Jira) when Notion AI is enabled
• Fetch page content, database schemas, or data sources by URL or ID
• Query databases using pre-defined view filters and sorts
• Query across multiple data sources with grouping and rollups (Enterprise + AI)

Page management:

• Create pages with properties, content, icons, and covers
• Apply database templates when creating or updating pages
• Update page properties, content, icons, and covers
• Move pages and databases to new parent locations
• Duplicate pages within the workspace

Database management:

• Create databases with custom property schemas
• Update data source properties, names, and descriptions
• Create views (table, board, list, calendar, timeline, gallery, form, chart, map, dashboard)
• Update view configuration (filters, sorts, grouping, display options)

Collaboration:

• Add page-level or block-level comments
• Reply to existing discussion threads
• List all comments and discussions on a page, including resolved threads
• Look up users and team information

Workflows

Find and summarize content: Search the workspace for a topic. Fetch the most relevant pages to read their full content. Summarize findings or extract action items.

Create structured content: Fetch a database to see its schema and available templates. Create pages with appropriate properties and template content. Set icons and covers for visual organization.

Manage project status: Query a database view to see current task states. Update page properties (status, assignee, priority, dates). Add comments for status updates or feedback.

Reorganize workspace: Search for pages that need restructuring. Move pages to new parent locations. Update views to reflect the new organization.

Gotchas

• Page IDs: Pages are identified by UUID or URL. Use search or fetch to get IDs before updating.
• Database templates: Fetch the database first to discover available templates before creating pages with them.
• View configuration: Views support a configuration DSL for filters, sorts, and grouping. Fetch existing views to understand the format before creating new ones.
• Connected sources search: Searching Slack, Google Drive, and Jira requires a Notion AI plan. Without it, search is limited to Notion content.
• Query capabilities: Querying across data sources requires Enterprise + AI. Querying a single database view requires Business + AI.
• Rate limits: 180 requests/minute overall, 30 searches/minute. Avoid parallel search operations to stay under limits.