​
When should you use this server

  • Pull meeting notes or project trackers directly from Notion databases.
  • Update tasks or write back summaries into shared workspaces.
  • Search across blocks, pages, or databases to surface relevant knowledge.
  • Automate repetitive workspace actions (create pages, append notes).

​
Key features

  • Page & block interaction — Retrieve, create, update, and delete pages and blocks (text, headings, todos, images).
  • Database operations — Query databases with filters and sorts, fetch entries, and add new rows.
  • Content search — Search for keywords or properties across an entire workspace.
  • User information — Look up metadata about workspace members.
  • Workspace organization — Understand nested page structure and database relationships.

​
Authentication

  • Method: OAuth2 via Notion integration.
  • Setup: You install the Notion MCP integration into your workspace, select which pages/databases to share, and complete the OAuth flow.
  • Notes: Minimum scopes are read:content, update:content, and databases; wider scopes may be needed for advanced actions.

​
Endpoints

Remote hosted MCP server (recommended): https://mcp.notion.com/sse
  • Provides OAuth sign-in, token-efficient streaming, and optimized AI usage.
Local MCP server (advanced):
Can be run with npm or Docker for offline or custom deployments: npx @notion/mcp-server
or docker run notion/mcp-server

​
Setup & usage

  1. Create a Notion integration and note the client ID/secret.
  2. Decide whether to connect via the hosted remote server (simplest, one-click OAuth) or run a local server.
  3. Add the MCP server config to your client (Claude Desktop, VS Code, Portkey Gateway).
  4. Complete OAuth flow (remote) or provide integration token (local).

​
Tools provided

Search across your Notion workspace and connected integrations (Slack, Google Drive, Jira). Falls back to basic workspace search if advanced AI features aren’t available.
  • Use cases:
    • “Check Slack for how we solved this bug in the past.”
    • “Search for documents mentioning ‘budget approval process.’”
    • “Look for meeting notes from last week with John.”
    • “Find all project pages that mention ‘ready for dev.‘“

​
fetch

Retrieve content from a Notion page or database by URL.
  • Use cases:

​
create-pages

Create one or more Notion pages with specified properties and content. If no parent is given, a private page will be created.
  • Use cases:
    • “Create a project kickoff page under our Projects folder with agenda and team info.”
    • “Make a new employee onboarding checklist in our HR database.”
    • “Create a meeting notes page for today’s standup with action items.”
    • “Add a new product feature request to our feature database.”

​
update-page

Update a page’s properties or content.
  • Use cases:
    • “Change the status of this task from ‘In Progress’ to ‘Complete.’”
    • “Add a new section about risks to the project plan page.”
    • “Update the due date on this project to next Friday.”
    • “Replace the old project timeline with the updated version.”

​
move-pages

Move one or more pages or databases to a new parent.
  • Use cases:
    • “Move my weekly meeting notes page to the ‘Team Meetings’ page.”
    • “Reorganize all project documents under the ‘Active Projects’ section.”

​
duplicate-page

Duplicate a Notion page. Runs asynchronously.
  • Use cases:
    • “Duplicate my project template page so I can use it for the new Q3 initiative.”
    • “Make a copy of the meeting agenda template for next week’s planning session.”

​
create-database

Create a new Notion database with specified properties.
  • Use cases:
    • “Create a new database to track customer feedback with fields for customer name, feedback type, priority, and status.”
    • “Set up a content calendar database with publish date, content type, and approval status.”

​
update-database

Update a database’s properties, name, description, or other attributes.
  • Use cases:
    • “Add a status field to track project completion.”
    • “Update the task database to include priority levels.”

​
create-comment

Add a comment to a page.
  • Use cases:
    • “Add a feedback comment to this design proposal.”
    • “Leave a note on the quarterly review page about budget concerns.”
    • “Comment on the meeting notes to clarify action item deadlines.”
    • “Add my thoughts to the product roadmap discussion.”

​
get-comments

List all comments on a page, including threaded discussions.
  • Use cases:
    • “List comments on the project requirements section.”
    • “Get all feedback comments from last week’s review.”

​
get-users

List all users in the workspace with details.
  • Use cases:
    • “Get contact details for the user who created this page.”
    • “Look up the profile of the person assigned to this task.”

​
get-user

Retrieve a user’s details by ID.
  • Use cases:
    • “What’s my email address?”
    • “What’s my Notion user ID?“

​
get-self

Retrieve information about the current bot user and the workspace it’s connected to.
  • Use cases:
    • “Which Notion workspace am I currently connected to?”
    • “What’s my file size upload limit for the current workspace?”

​
Notes

  • First, always verify you’re connecting to Notion’s official MCP endpoints:
  • When setting up workflows, carefully review the permissions and data access levels of each agent and MCP tool.
Source: Notion MCP docs