Notion MCP Server

by v-3
Verified

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Enables interaction with Notion workspaces, providing tools for searching, reading, creating and updating pages, managing comments, performing block-level operations, and working with databases including creating, querying, and updating database items with various property types.

Notion MCP サーバー

Notionとのシームレスな統合を実現するモデルコンテキストプロトコル(MCP)サーバー。このサーバーにより、言語モデルは標準化されたツール(ページやデータベースの検索、読み取り、作成、更新ツールなど)を通じてNotionワークスペースと連携できるようになります。

🌟 主な機能

ページ操作

  • 🔍 Notionワークスペースを検索する
  • 📝 豊富なマークダウンコンテンツで新しいページを作成する
  • 📖 ページのコンテンツをきれいなフォーマットで読み上げる
  • 🔄既存のページを更新する
  • 💬 コメントを追加および取得する
  • 🧱 ブロックレベルの操作(更新、削除)

強化されたマークダウンサポート

  • 複数の見出しレベル(H1~H3)
  • 言語サポート付きのコードブロック
  • チェックボックスの状態を持つインタラクティブな ToDo 項目
  • 複数行をサポートするブロック引用
  • 水平区切り線
  • キャプション付きの画像
  • ネストされた箇条書き

データベース操作

  • データベースの作成と管理
  • データベース項目の追加と更新
  • フィルターと並べ替えを使用したクエリ
  • さまざまなプロパティ タイプのサポート:
    • タイトル、リッチテキスト、番号
    • 選択、複数選択
    • 日付、チェックボックス
    • さらにもっと!

🚀 はじめに

前提条件

  • Node.js (v16 以上)
  • Notion APIキー
  • MCP 互換クライアント (例: Claude Desktop)

インストール

  1. リポジトリをクローンします。
git clone https://github.com/v-3/notion-server.git cd notion-server
  1. 依存関係をインストールします:
npm install
  1. 環境を設定します。
# Create .env file echo "NOTION_API_KEY=your_notion_api_key_here" > .env # Or export directly export NOTION_API_KEY=your_notion_api_key_here
  1. サーバーを構築します。
npm run build

🔧 構成

クロードデスクトップセットアップ

  1. Claude Desktop の構成 ( claude_desktop_config.json ) を更新します。
{ "mcpServers": { "notion": { "command": "node", "args": ["/absolute/path/to/notion-server/build/index.js"], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }
  1. 変更を適用するには、Claude Desktop を再起動してください。

🛠️ 利用可能なツール

ページ操作

// Search pages { query: string // Search query } // Read page { pageId: string // ID of the page to read } // Create page { title?: string, // Page title content?: string, // Page content in markdown parentPageId: string // Parent page ID properties?: object // For database items } // Update page { pageId: string, // Page ID to update content: string, // New content type?: string // Content type }

データベース操作

// Create database { parentPageId: string, title: string, properties: object } // Query database { databaseId: string, filter?: object, sort?: object }

🔐 Notionアクセスの設定

統合の作成

  1. Notionの統合をご覧ください
  2. 「新しい統合」をクリックします
  3. 権限を設定します。
    • コンテンツ: 読み取り、更新、挿入
    • コメント: 読む、作成する
    • ユーザー情報: 読む

ページの接続

  1. Notionページを開く
  2. 「...」メニュー→「接続」をクリック
  3. 統合を追加する
  4. 必要に応じて他のページでも繰り返します

📝 使用例

ページの作成

const result = await notion.create_page({ parentPageId: "page_id", title: "My Page", content: "# Welcome\nThis is a test page." });

データベースのクエリ

const result = await notion.query_database({ databaseId: "db_id", filter: { property: "Status", select: { equals: "In Progress" } } });

🤝 貢献する

貢献を歓迎します!ご協力をお願いします:

  1. リポジトリをフォークする
  2. 機能ブランチを作成する
  3. プルリクエストを送信する

📜 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

🙏 謝辞

このプロジェクトはsweir1/notion-serverによって大幅に改善され、以下の更新が行われました:

  • より多くのブロックタイプによるマークダウンサポートの強化
  • 包括的なデータベース操作
  • エラー処理とデバッグの改善
  • データベース項目のプロパティ処理の改善
  • よりクリーンなページ出力フォーマット

sweir1 のバージョンを使用するには、リポジトリをクローンします。

git clone https://github.com/sweir1/notion-server.git
-
security - not tested
A
license - permissive license
-
quality - not tested

ページやデータベースを検索、読み取り、作成、更新するための標準化されたツールを通じて、言語モデルが Notion ワークスペースと対話できるようにします。

  1. 🌟 Key Features
    1. Page Operations
    2. Enhanced Markdown Support
    3. Database Operations
  2. 🚀 Getting Started
    1. Prerequisites
    2. Installation
  3. 🔧 Configuration
    1. Claude Desktop Setup
  4. 🛠️ Available Tools
    1. Page Operations
    2. Database Operations
  5. 🔐 Setting Up Notion Access
    1. Creating an Integration
    2. Connecting Pages
  6. 📝 Usage Examples
    1. Creating a Page
    2. Querying a Database
  7. 🤝 Contributing
    1. 📜 License
      1. 🙏 Acknowledgments
        ID: lynmv5klr9