MCP 服务器 · 发布者仓库

Notion MCP Server

Notion 官方维护的 MCP 服务器,通过内部集成 Token 让 Agent 读取和操作授权页面与数据库。

4.6k StarsMITTypeScript24 天前更新
01

项目介绍

Notion MCP Server 是一项MCP 服务器,核心内容是Notion 官方维护的 MCP 服务器,通过内部集成 Token 让 Agent 读取和操作授权页面与数据库。它把读取 Notion 页面、检索工作区内容放在同一个公开项目里,安装前可以先看清目录、命令和限制,再决定是否接入自己的 Agent 工作流。

02

核心功能

01

读取 Notion 页面

仓库 README 或组件说明记录了读取 Notion 页面的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。

02

检索工作区内容

仓库 README 或组件说明记录了检索工作区内容的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。

03

操作数据库条目

仓库 README 或组件说明记录了操作数据库条目的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。

04

把知识库接入 Agent

仓库 README 或组件说明记录了把知识库接入 Agent的用途。实际启用前应继续查看原文,确认当前版本的行为和依赖。

03

安装与连接

按照公开 GitHub 说明配置 Notion MCP Server,首次接入时保持较小权限范围,再用低风险任务验证,确认正常后再投入日常使用。

AI AGENT INSTALL

让 AI Agent 帮你安装

把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。

请帮我安装并配置Notion MCP Server。
项目地址:https://github.com/makenotion/notion-mcp-server

请先阅读仓库 README 和许可证,确认当前宿主、依赖、目标目录与所需权限。严格采用仓库记录的方法,不要把凭据写进文件或日志;如果支持只读或最小权限模式,优先从该模式开始。完成后运行一个小型验证,并告诉我实际修改、执行命令、配置位置和验证结果。遇到覆盖文件或扩大权限的操作时先停下说明。
01开始前准备
  • 在 Notion 创建内部集成
  • 把需要访问的页面分享给该集成
  • Node.js 与 npx
02复制安装命令或配置
{"mcpServers":{"notion":{"command":"npx","args":["-y","@notionhq/notion-mcp-server"],"env":{"NOTION_TOKEN":"YOUR_NOTION_INTEGRATION_TOKEN"}}}}
03按步骤完成安装
  1. 1
    确认依赖和使用范围

    先读 README,确认目标宿主,并准备这些条件:在 Notion 创建内部集成;把需要访问的页面分享给该集成;Node.js 与 npx。执行前检查目标目录和权限范围。

  2. 2
    按仓库方式完成配置

    执行仓库给出的命令: npx -y @notionhq/notion-mcp-server

  3. 3
    用小任务验证

    重启 MCP 宿主,确认服务器列表中出现 Notion MCP Server。先调用一个低风险的只读工具,能够返回预期结果且没有认证错误,就说明连接正常。

如何确认安装成功

重启 MCP 宿主,确认服务器列表中出现 Notion MCP Server。先调用一个低风险的只读工具,能够返回预期结果且没有认证错误,就说明连接正常。

使用前注意
  • 集成 Token 必须作为密钥保存
  • 给集成过宽权限会扩大 Agent 可读取和修改的内容
04

使用场景

SCENARIO 01

让 Agent 查询团队知识库

当仓库记录的依赖和权限模型与当前环境相符时,可以把它用于让 Agent 查询团队知识库。

SCENARIO 02

从 Notion 整理项目资料

当仓库记录的依赖和权限模型与当前环境相符时,可以把它用于从 Notion 整理项目资料。

SCENARIO 03

辅助维护数据库条目

当仓库记录的依赖和权限模型与当前环境相符时,可以把它用于辅助维护数据库条目。

05

使用评价

这次评价依据仓库 README、组件说明、许可证和维护元数据。比较值得肯定的是由 Notion 维护,接口与权限模型有明确来源;只有分享给集成的页面才会进入访问范围。同时也要把限制说清楚,集成 Token 必须作为密钥保存;给集成过宽权限会扩大 Agent 可读取和修改的内容。本次收录没有把资料核验写成本机实测。

值得一试的地方

  • 由 Notion 维护,接口与权限模型有明确来源
  • 只有分享给集成的页面才会进入访问范围

使用前要知道

  • 集成 Token 必须作为密钥保存
  • 给集成过宽权限会扩大 Agent 可读取和修改的内容
06

README

Notion MCP Server


Overview

Notion 官方维护的 MCP 服务器,通过内部集成 Token 让 Agent 读取和操作授权页面与数据库。 Notion 官方维护的 MCP 服务器,通过内部集成 Token 让 Agent 读取和操作授权页面与数据库。

Getting started

  • 按照公开 GitHub 说明配置 Notion MCP Server,首次接入时保持较小权限范围,再用低风险任务验证,确认正常后再投入日常使用。
  • 仓库把 Notion MCP Server 定位为Notion 官方维护的 MCP 服务器,通过内部集成 Token 让 Agent 读取和操作授权页面与数据库。重点不在做一份泛泛的合集,而是把读取 Notion 页面、检索工作区内容、操作数据库条目、把知识库接入 Agent这些能力整理成可以继续使用或核验的内容。
  • 从公开 README 可以确认的要点包括Notion 官方维护、使用内部集成 Token、页面需要显式授权、通过 npx 启动。这些信息来自仓库说明和目录,本次收录没有把文档描述写成已经在本机完成的实测结果。
  • 重启 MCP 宿主,确认服务器列表中出现 Notion MCP Server。先调用一个低风险的只读工具,能够返回预期结果且没有认证错误,就说明连接正常。

Configuration

{"mcpServers":{"notion":{"command":"npx","args":["-y","@notionhq/notion-mcp-server"],"env":{"NOTION_TOKEN":"YOUR_NOTION_INTEGRATION_TOKEN"}}}}
在 GitHub 阅读完整 README