SM

suekou/mcp-notion-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

925 stars 181 forks 品質 80 トレンド 26MIT

NotionをMCP互換クライアントに接続するためのモデルコンテキストプロトコルサーバー

概要

Notion API用のAIフレンドリーMCPサーバー。エージェントがNotionワークスペースを見つけ、読み取れ、クエリし、更新するのを支援しつつ、日常的なAIワークフローに適した簡潔な応答を保ちます。 このサーバーはNotion API 2026-03-11をターゲットにしており、現在のデータベース/データソースモデルを使用しています。MCPツール、プロンプト、リソース、構造化ツールの結果、インタラクティブなNotionワークフロー用のオプションMCPアプリを公開します。 - notion_findによる検索およびターゲット発見。- notion_read_pageによる安定したブロックIDによるコンパクトなページ読み取り。- notion_inspect_data_sourceによるデータソーススキーマ検査。- シンプルな値によるスキーマ対応のデータソースクエリとアイテム作成。- 段落、見出し、リスト、ToDo、引用、コールアウト、コードブロック、区切り、安全なMarkdownアペンドのためのシンプルなページ編集ツール。- 高度なブロック、ページ、データベース、データソース、コメント、ユーザー操作のためのRaw Notion APIツール。- オプションのMCPアプリ:Data Source ExplorerおよびPage Workbench。

概要(AI 翻訳)

Notion API用のAIフレンドリーMCPサーバー。エージェントがNotionワークスペースを見つけ、読み取れ、クエリし、更新するのを支援しつつ、日常的なAIワークフローに適した簡潔な応答を保ちます。

このサーバーはNotion API 2026-03-11をターゲットにし、現在のデータベース/データソースモデルを使用しています。MCPツール、プロンプト、リソース、構造化ツールの結果、そしてインタラクティブなNotionワークフローのためのオプションMCPアプリを公開しています。

ハイライト

  • notion_findによる探索およびターゲット発見。
  • notion_read_pageによる安定したブロックIDによるコンパクトなページ読み取り。
  • notion_inspect_data_sourceによるデータソーススキーマ検査。
  • スキーマ認識型のデータソースクエリおよび単純な値によるアイテム作成。
  • 段落、見出し、リスト、Todo、引用、コールアウト、コードブロック、区切り、安全なMarkdown追加のための簡単なページ編集ツール。
  • 高度なブロック、ページ、データベース、データソース、コメント、ユーザー操作のためのRaw Notion APIツール。
  • オプションMCPアプリ:データソースエクスプローラーおよびページワークベンチ。

クイックスタート

このサーバーをClaude DesktopのようなMCPホストに追加します:

設定を保存した後、MCPホストを再起動してください。

セットアップガイド

1.Notion統合を作成する

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Notion MCP Server

AI-friendly MCP server for the Notion API. It helps agents find, read, query, and update Notion workspaces while keeping responses compact enough for day-to-day AI workflows.

This server targets the Notion API 2026-03-11 and uses the current database/data source model. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.

Highlights

  • Search and target discovery with notion_find.
  • Compact page reading with stable block IDs via notion_read_page.
  • Data source schema inspection with notion_inspect_data_source.
  • Schema-aware data source querying and item creation with simple values.
  • Simple page editing tools for paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers, and safe Markdown append.
  • Raw Notion API tools for advanced block, page, database, data source, comment, and user operations.
  • Optional MCP Apps: Data Source Explorer and Page Workbench.

Quick Start

Add this server to an MCP host such as Claude Desktop:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

Restart your MCP host after saving the configuration.

Setup Guide

1. Create a Notion integration

Open the Notion integrations dashboard, then create a new internal integration.

2. Configure capabilities

Grant only the capabilities you need:

  • Read content: required for search, page reads, data source retrieval, and queries.
  • Insert content: required for creating pages/items and appending blocks.
  • Update content: required for updating pages, blocks, and data source schemas.
  • Read comments / Insert comments: required only for comment tools.
  • User information: required only when using user lookup tools.

For full functionality during setup, enable read, insert, and update content. Add comment or user capabilities only if you plan to use those tools.

3. Grant content access

Open the Content access tab for your integration, then select the pages or databases you want the MCP server to read or edit.

You can also grant access from the target Notion page or database: open the ... menu, choose Connections, then add your integration.

Notion only lets an integration access pages and databases that have been shared with it. A connection added to a page can also access that page’s children.

4. Copy the internal integration token

Copy the integration secret. This value becomes NOTION_API_TOKEN in your MCP host config.

GitHub で README 全文を見る

インストール

npx -y @suekou/mcp-notion-server
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "notion": { "command": "npx", "args": ["-y", "@suekou/mcp-notion-server"], "env": { "NOTION_API_TOKEN": "your-integration-token" } } } }