Notion MCP サーバー

Notion API に接続し、Claude の Machine Context Protocol (MCP) を通じて機能を公開するサーバー。

特徴

• タイトルまたはコンテンツでNotionページを検索

• ページの詳細とコンテンツを取得する

• Notionデータベースのクエリ

• Notionで新しいページを作成する

Related MCP server: Notion MCP Server

設定

1. このリポジトリをクローンします:

git clone https://github.com/yourusername/notion-mcp-server.git
cd notion-mcp-server

2. 依存関係をインストールします:

npm install

3. ルート ディレクトリに次の内容の.envファイルを作成します。

NOTION_API_KEY=your_notion_api_key_here
PORT=3000
# Optional: if you want to query a specific database by default
NOTION_DATABASE_ID=your_notion_database_id_here

4. Notion API キーを取得します:

   • https://www.notion.so/my-integrationsにアクセスしてください。

   • 新しい統合を作成する

   • 「内部統合トークン」をコピーします

   • このトークンをNOTION_API_KEYとして.envファイルに追加します。

5. Notion 統合をワークスペースに接続します。

   • Notionワークスペース内のページまたはデータベースに移動します

   • 右上の「…」メニューをクリックします

   • 「接続を追加」を選択

   • 統合を見つけて追加する

サーバーの実行

開発モードでサーバーを起動します。

npm run dev

または本番モードでは:

npm start

サーバーは、 .envファイルで指定されたポート (デフォルト: 3000) で実行されます。

APIエンドポイント

通常のHTTPエンドポイント

• POST /api/notion/search

  • Notionでページを検索する

  • 本文: { "query": "search term" }

• /api/notion/page にPOSTする

  • IDでページを取得する

  • 本文: { "page_id": "page-id-here" }

• POST /api/notion/database/query

  • データベースをクエリする

  • 本文: { "database_id": "database-id-here", "filter": {}, "sorts": [] }

• /api/notion/page/create をPOSTする

  • 新しいページを作成する

  • 本文: { "parent": {}, "properties": {}, "children": [] }

MCP統合

サーバーは、利用可能な関数を記述する MCP マニフェストを/mcp/manifest.jsonで公開します。

MCP 関数を呼び出すには、次の構造の POST リクエストを/api/notion/mcp/invokeに送信します。

{
  "function_name": "search_pages",
  "parameters": {
    "query": "search term"
  }
}

利用可能なMCP機能

• search_pages - タイトルまたはコンテンツでNotionページを検索

• get_page - IDでNotionページを取得する

• query_database - Notionデータベースをクエリする

• create_page - Notionで新しいページを作成する

ライセンス

マサチューセッツ工科大学