Notion MCP Server
A Notion MCP server: the agent searches, reads, queries and updates workspace pages and databases
- 925 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Writes and updates real Notion pages and databases
- Handles a workspace access token
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/suekou-mcp-notion-serverDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Writes and updates real Notion pages and databases
- Handles a workspace access token
This is third-party code. Review the repository files before installing.
What it does
The server connects the agent to the Notion API and keeps responses compact for day-to-day work. The agent searches pages and targets via notion_find, reads pages with stable block IDs, inspects data source schemas and runs schema-aware queries, and creates items with simple values. There are simple editing tools for paragraphs, headings, lists, todos, quotes, callouts, code blocks and safe Markdown append, plus raw API calls for advanced block, page, database, comment and user operations. It targets Notion's current database and data source model and can return structured results, prompts and resources, plus optional interactive apps.
Who it is for. For teams and specialists who keep documents and databases in Notion and want to manage them through an agent.
Good fit when
- You need the agent to search and read Notion pages
- You need to query databases and create items
- You need to edit pages or append content from the agent
Not a fit when
- You have no Notion integration and token
- You cannot give the agent access to the workspace
Example request
Find the tasks database in Notion and add a new task due FridayMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
NOTION_API_TOKENrequired, secret- Notion internal integration token with the needed read, insert and update rights
Limitations
It needs a Notion internal integration token and only sees what the integration is granted. Read, insert and update permissions are set on the integration, so grant only what is needed. Update operations change real pages and databases.
How to disable. Remove the notion server from your MCP config and optionally disable the integration in Notion.
FAQ
Where do I get the token?
Create an internal integration in the Notion integrations dashboard and grant it only the read, insert and update rights you need.
Can the server change data?
Yes, with the granted rights it creates and updates pages, blocks and database items.
Discussion
No questions or reviews yet.
Related
MCP serversOfficial local MCP server for the Notion API: search, read and edit pages as Markdown, and work with databases
Notion MCP (awkoy)
Notion MCP Server (awkoy)
Notion MCP on a token: an agent searches pages, runs databases, edits blocks and comments through three tools and 47 operations, with no manual sign-in
Simplenote MCP: Simplenote notes in an agent
simplenote-mcp
Automattic's official Simplenote MCP server: an agent reads, searches and optionally edits notes, with no sign-in on macOS
An MCP server for Apple Notes on Mac: the agent reads, searches, creates, edits and exports notes and manages folders and tags.
Official Anytype MCP server: an agent searches, creates and edits objects, lists and types in your knowledge base
The noteriv-mcp server opens a Noteriv vault to agents: reading, writing, search, tags, backlinks and daily notes, all locally.
README in short
The README describes an MCP server for the Notion API that helps an agent search, read, query and update workspaces while keeping responses compact. It targets the current database and data source model, offers editing tools, raw API calls and optional interactive apps. Install is via npx with a NOTION_API_TOKEN variable, with a guide for creating an integration and granting rights. MIT licensed.