Notion MCP server
Create, update, and manage pages, databases, and workspace users
31 stars155 downloads/wk
Reviews
Write oneNobody has reviewed Notion yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Notion tools (41, 20 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
append_block_childrenAppend child blocks to a parent block. Allows adding up to 100 child blocks in a single request, with optional positioning control.
complete_file_uploadwrite actionFinalize a multi-part file upload by marking it as complete. This operation signals that all file chunks have been uploaded and the file is ready for processing.
create_commentwrite actionCreates a new comment in Notion. The request body should contain the comment content and metadata required by the Notion API.
create_data_sourcewrite actionCreate a new data source within a Notion database by defining its property schema. This establishes the structure and metadata for how data will be organized in the specified parent database.
create_databasewrite actionCreates a new database in Notion within a specified parent page or workspace. Optionally configure the database with a title, description, properties schema, icon, and cover image.
create_file_uploadwrite actionInitiate a file upload to Notion, supporting single-part uploads for files under 20MB, multi-part uploads for larger files, or external URL imports for publicly hosted files.
create_pagewrite actionCreates a new page in Notion. Specify the parent location, page properties, and optional visual elements like icons and covers. You can also include child blocks and apply templates during creation.
create_viewwrite actioncreate_view_querywrite actionCreate a new query within a Notion view to retrieve filtered or sorted results. Specify pagination preferences to control the number of results returned per request.
delete_blockwrite actionPermanently delete a block from a Notion workspace. This action cannot be undone.
delete_viewwrite actionPermanently delete a view by its ID. This operation removes the view and cannot be undone.
delete_view_querywrite actionPermanently delete a specific query from a view. This operation removes the query and cannot be undone.
get_blockRetrieve a specific block by its ID from Notion. Returns the block's properties and content.
get_commentRetrieve a specific comment by its ID from the Notion API. Returns the full comment object with all associated metadata.
get_data_sourceRetrieve a specific data source by its ID. Returns the complete configuration and metadata for the requested data source.
get_databaseRetrieve detailed information about a specific database by its ID. Returns the database's properties, configuration, and metadata.
get_file_uploadwrite actionRetrieve details about a specific file upload by its ID. Use this to check the status and metadata of a previously initiated file upload.
get_pageRetrieve a single page by its ID from Notion. Optionally filter the response to include only specified properties.
get_page_markdownRetrieve a Notion page in markdown format. Optionally include meeting note transcripts or use placeholder URLs instead.
get_page_propertyRetrieve a specific property item from a Notion page. Use this to fetch individual property values associated with a page.
get_selfRetrieve the bot user associated with your API token. This returns information about the authenticated user making the request.
get_userRetrieve a specific user by their ID. Returns the user's profile information and details.
get_viewRetrieve a specific view by its ID from Notion. Returns the view's configuration and metadata.
get_view_query_resultsRetrieve the results of a query executed against a Notion view. Returns paginated results from the specified view and query.
list_block_childrenRetrieve all child blocks contained within a specified parent block. Use this to navigate the hierarchical structure of Notion blocks and access nested content.
list_commentsRetrieve a paginated list of comments for a specific block in Notion. Use pagination parameters to control the number of results returned.
list_custom_emojisRetrieve a list of custom emojis from your Notion workspace. Optionally filter by exact name match to resolve a specific emoji to its ID.
list_data_source_templatesRetrieve a paginated list of templates available within a specific data source, with optional filtering by name.
list_file_uploadsRetrieve a paginated list of file uploads with optional filtering by status. Use this to monitor the progress and state of files being uploaded to the system.
list_usersRetrieve a paginated list of all users in the system. Use pagination parameters to control result size and navigate through user records.
list_viewsRetrieve a paginated list of views, optionally filtered by database or data source. Use this to discover available views in your workspace.
move_pageMove a page to a new parent location within Notion. The page will be relocated under the specified parent, updating its position in the page hierarchy.
query_data_sourcewrite actionExecute a query against a data source to retrieve filtered, sorted results. Supports pagination and optional filtering by result type (pages or data sources).
search_pages_by_propertySearch for pages in Notion by filtering on a specific property value, with results sorted by last edited time in your preferred direction.
send_file_uploadwrite actionUpload file contents to a file upload session, supporting multipart uploads for files larger than 20MB.
update_blockwrite actionUpdate the properties of an existing block in Notion. Modify block content, formatting, or other attributes using the provided block ID.
update_data_sourcewrite actionUpdate a data source in Notion, including its title, icon, properties, and trash status. Use the database_id to specify the parent database containing this data source.
update_databasewrite actionUpdate properties of an existing database in Notion, including its title, description, icon, cover, parent location, inline display status, trash status, and lock state. Only provided fields will be updated; omitted fields remain unchanged.
update_pagewrite actionUpdate a Notion page's properties, appearance, content, and metadata. Supports modifying page title/properties, icon, cover image, lock status, archived state, and content via template replacement or erasure.
update_page_markdownwrite actionUpdate a Notion page's content using markdown. Supports inserting new content, replacing specific ranges, performing search-and-replace operations, or replacing the entire page content.
update_viewwrite actionUpdate a view's configuration, including its name, filters, sorts, quick filters, and presentation settings. Changes are applied to the specified view.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan5 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 138 days ago8/15
- Maintainer identityregistry namespace matches repository owner7/10
How Notion compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 80/100
- higher than 53% of 1,299 Productivity servers
- Tools
- 41
- the typical Productivity server has 7
- Tools that change things
- 49%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 31
- more than 86% of 854 Productivity servers
- Downloads a week
- 155
- more than 66% of 427 Productivity servers with a package
What its tools let an agent do: 20 read · 7 create · 10 change · 3 delete · 1 send or post
Install Notion in Claude Code, Cursor or VS Code
claude mcp add notion -- uvx mcparmory-notion
What the publisher says
From the Notion repository's README, as published. We do not edit it. Read it on GitHub
MCP Armory Registry
Production-ready MCP servers for popular APIs, generated by MCP Blacksmith.
Servers · Install & Usage · Features · How it works · License
MCP servers that connect AI agents to real-world APIs. Each server is a standalone Python package — generated from the upstream OpenAPI spec using MCP Blacksmith and tested against the live API before release. Hosted on MCP Armory or run independently.
<!-- SERVERS:BEGIN -->
Servers
🧠 AI & Machine Learning   ElevenLabs · Linkup · Parallel · Perplexity AI · Ragie · Replicate
📊 Analytics   Ahrefs · Datadog · Google Analytics · Google Search Console · Linkly · Mixpanel · PostHog
⛓️ Blockchain & Crypto   Alchemy NFT
💼 CRM & Sales   Apollo
💬 Communication   Atlassian Confluence · Google Gmail · MailerSend · Mailtrap · Postmark · Resend · Slack
🗄️ Data & Databases   Enigma · Pinecone
🛠️ Developer Tools   AgentQL · Apify · Bitbucket · Bright Data · Browserbase · BuiltWith · Canvas · CircleCI · Codacy · Contentful Management · ConvertAPI · E2B · Firecrawl · GitHub · GitLab · LaunchDarkly · Postman · Scrapingant · Semrush AppCenter · Sentry
📄 Documents & Printing   PDF.co
🛒 E-commerce   Shopify Admin
💰 Finance   Alpha Vantage · Polygon · Ramp
👥 HR & Recruiting   BambooHR
☁️ Infrastructure   Globalping · Grafana · PagerDuty · Rootly · Runpod
⚖️ Legal & Compliance   NetLicensing
🗺️ Maps & Location   Google Maps Platform · IP2Location.io IP Geolocation · OpenCage Geocoding
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Notion: common questions
- Is Notion MCP server safe?
- Mostly: it is graded B (80/100). Read the Notion safety report
- How do I install Notion?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Notion need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Notion maintained?
- The last commit was 176 days ago (2026-05-12). The latest release is v1.0.2.
- What can I use instead of Notion?
- Servers from other publishers that do the same job: Better Notion MCP server, Remnus MCP server and Farm.js Docs MCP server.
- How does Notion compare with other Productivity MCP servers?
- safety score 80/100 (higher than 53% of 1,299 Productivity servers); tools 41 (the typical Productivity server has 7); tools that change things 49% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Notion
Same job from other publishers: the closest match first, then the best rated.
- Better NotionMarkdown-first Notion for AI agents -- pages, databases, blocks, and comments in one call.not reviewedEstablishedB
- RemnusMCP-native open-source Notion alternative: read & write pages, databases and kanban boards.not reviewedGrowingA
- Farm.js DocsSearch and read the Farm.js docs: pages, sections, code examples and config options.not reviewedEstablishedA
- artifact-siteOne place for every AI agent's pages and docs: versioned links to share, search and update.not reviewedEstablishedC
- Research HubResearch workspace for Zotero + Obsidian + NotebookLM. Search, ingest, sync, verify briefs.not reviewedGrowingA