安装

其他安装命令

macOS

Homebrew已验证 · 100%

brew install notion-mcp-server

local Homebrew formula metadata

概览

软件包摘要

MCP Server for Notion

项目链接

命令和别名

notion-mcp-server

历史

项目历史与用法

The local Notion MCP server is Notion's official package for exposing the Notion API through the Model Context Protocol. The GitHub repository was created on 2025-03-10, the npm package @notionhq/notion-mcp-server was first published on 2025-04-03, and Homebrew packages the same tool as notion-mcp-server.

The package occupies a transitional spot in Notion's AI-tooling story. Notion's developer docs now emphasize the hosted Notion MCP service at https://mcp.notion.com/mcp, while the local server README says active support is prioritized for the remote service and notes that the local repository may be sunset.

项目历史

The server started as a local MCP wrapper around the Notion API. Its README documents installation through npx, Docker, and MCP client JSON config, with NOTION_TOKEN or OPENAPI_MCP_HEADERS used to pass Notion credentials.

Version 2.0.0 moved the local server to the Notion API 2025-09-03 surface, replacing database-oriented tools with data-source-oriented tools. Later README text also documents Markdown-oriented page tools tied to the Notion API 2026-03-11 operation version.

采用历史

Adoption was driven by the 2025-2026 MCP wave rather than by older Notion API automation. The repository had 4,473 GitHub stars and 589 forks when queried on 2026-07-01, and npm reported 2,135,387 downloads for @notionhq/notion-mcp-server from 2025-06-29 through 2026-06-28.

Homebrew's formula API reported 453 install-on-request events over its 365-day analytics window. That is small next to npm usage, which matches the package's main distribution path: MCP clients usually run it through npx or Docker rather than as a long-lived Homebrew CLI.

使用方式

Package users add the server to MCP-capable tools such as Claude Desktop, Cursor, Zed, GitHub Copilot CLI, or similar clients, then provide a Notion integration token. Practical use is agent access to Notion pages and databases/data sources: searching workspace content, reading page content, creating comments or pages, and editing page Markdown.

Notion's hosted MCP documentation recommends OAuth against https://mcp.notion.com/mcp for many clients. Package nerds should treat the Homebrew formula as a convenience for local/offline or pinned-tool workflows, not as the primary future-facing Notion integration path.

为什么软件包爱好者会关心

This is a good example of a vendor-owned MCP package being overtaken by a hosted MCP endpoint. The package is still useful for reproducible local toolchains, but the official docs now steer users toward a remote, OAuth-backed server.

时间线

2025-03-10: GitHub repository created.
2025-04-03: npm package @notionhq/notion-mcp-server created.
2026-01-31: GitHub release v2.1.0 published.
2026-06-22: npm package modified to version 2.4.1.

Related projects

Notion MCP hosted service
Notion API
Model Context Protocol
claude-code-notion-plugin

来源

安全态势

风险级别：blue

broad file, network, media, or database tool signal.

风险分类器

blue 风险 · 中置信度 · tool

原因

broad file, network, media, or database tool signal

信号

text:server

安装行为

formula 元数据中未记录 Homebrew post-install 钩子。
Homebrew bottle 元数据适用于 1 个平台目标。
安装时包含 1 个运行时依赖。

建议审查

在无人值守的代理使用前，请检查该工具是否读取明文凭据、写入远程状态、发布制品或调用插件。

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Unix: .cursor/mcp.json~/.copilot/mcp-config.json

Credential files

Credential-bearing paths to review before unattended agent runs.

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Unix: .cursor/mcp.json~/.copilot/mcp-config.json

可执行文件

已安装的可执行文件

命令	类型	暴露范围	备注
`notion-mcp-server`	cli	全局可执行文件

新鲜度

版本和新鲜度

这些信号区分页生成时间、软件包管理器活动和上游发布比较。只有存在证据 URL 和可比较版本时，才会提示版本落后。

页面生成时间2026-07-08

管理器版本2.4.1

管理器更新时间2026-06-23

本地数据OK

上游not checked

信息No cached GitHub release or tag data was available.https://github.com/makenotion/notion-mcp-servernone 置信度

安装元数据

软件包元数据

软件包键	brew:notion-mcp-server
版本	2.4.1
软件包管理器	Homebrew
软件包管理器页面	https://formulae.brew.sh/formula/notion-mcp-server
主页	https://github.com/makenotion/notion-mcp-server
仓库	https://github.com/makenotion/notion-mcp-server
上游文档	https://developers.notion.com/docs/get-started-with-mcp
许可证	MIT
源码归档	https://registry.npmjs.org/@notionhq/notion-mcp-server/-/notion-mcp-server-2.4.1.tgz
最后更新	2026-06-23T21:55:45Z
Pulse	updated
依赖	node
Bottle	可用 (于 all)
Homebrew post-install	未定义
服务	未声明

注册表事实

源数据库详情

Source Database	Homebrew formula API
Tap	homebrew/core
Full Name	notion-mcp-server
Version Scheme	0
Revision	0
Bottle Stable Root URL	https://ghcr.io/v2/homebrew/core
Deprecated	no
Disabled	no
Keg Only	no
URL Keys	stable

软件包图谱

链接来自本地软件包关系图、补充数据、依赖边、生态匹配和软件包 hub 归属。

来源线索

由仓库数据生成

此页面由 av-web 从 scripts/generate-pkg-sqlite.py 生成的私有软件包 SQLite 工件提供。

Combined YAML source

View the package source record on GitHub.

combined/notion-mcp-server.yml

使用的来源

Geiger risk classifier
Nucleus package database
av.db category and tag curation
cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
package relationship graph
package version freshness
package-page enrichment

使用 Homebrew 安装 notion-mcp-server