remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Exposes the official Notion SDK, allowing interaction with Notion workspaces. Provides tools for searching, querying databases, creating and updating pages, managing content blocks, working with users, adding comments, and creating link previews.

Notion MCP サーバー

公式の Notion SDK を公開し、AI モデルが Notion ワークスペースと対話できるようにする Model Context Protocol (MCP) サーバー。

クイックスタート

1. Notionの統合を設定する

https://www.notion.so/my-integrationsにアクセスしてください。
新しい統合を作成する
APIキーをコピーする

2. Notionページを統合に接続する

統合によって Notion コンテンツにアクセスするには、ページまたはデータベースを明示的に共有する必要があります。

統合を通じてアクセスしたいNotionページまたはデータベースに移動します
右上隅の「共有」ボタンをクリックします
「ユーザー、グループ、または統合を追加」フィールドで、ドロップダウンリストから統合を選択します。
「招待」をクリック
アクセス可能にしたいページまたはデータベースごとに繰り返します

**注:**統合は、明示的に共有されたページとデータベースにのみアクセスできます。子ページは親ページからアクセスを自動的に継承します。

3. AIアシスタントに追加する

次のいずれかの構成形式を使用して、この MCP サーバーを Claude Desktop、Cursor AI、または Claude.ai に追加できます。

コマンドライン形式

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

JSON設定フォーマット

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

your-notion-integration-key手順 1 の API キーに置き換えます。

セットアップ手順

Claude Desktop ：設定 > 詳細設定 > モデルコンテキストプロトコル
カーソルAI : 設定 > AI > MCPサーバー
Claude.ai (Web) : プロフィール > 設定 > APIと統合 > モデルコンテキストプロトコル

利用可能なツール

サーバーは、Notion と対話するためのツールを提供します。

検索: ページまたはデータベースを検索
データベース: データベースエントリのクエリと取得
ページ: ページの作成、取得、更新
ブロック: コンテンツブロック (段落、リストなど) を管理します。
ユーザー: ユーザーを一覧表示し、ユーザー情報を取得する
コメント: コメントの作成と一覧表示
リンクプレビュー: URLのリンクプレビューを作成する

代替設定方法

環境変数の使用

API キーを直接渡す代わりに、 .envファイルを使用することもできます。

次の内容で.envファイルを作成します。

NOTION_API_KEY=your-notion-integration-key

サーバーを実行します。

npx @ramidecodes/mcp-server-notion@latest -y

環境変数を使用した JSON 構成 (Claude デスクトップ用)

JSON 構成形式で環境変数を使用することもできます。

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

コマンドラインオプション

OPTIONS:
  -h, --help              Show help message
  -v, --version           Show version information
  --verbose               Enable verbose logging
  --env-path <path>       Path to .env file
  --api-key <key>         Notion API key
  -y                      Skip confirmation prompts

トラブルシューティング

「クライアントの作成に失敗しました」というエラーが発生した場合:

Windowsでは、npxコマンドの前にcmd /cを使用してください。
macOS/Linuxでは、npxへのフルパスを使用してみてください。
AIアシスタントに追加する前に、ターミナルでコマンドをテストしてください

よくある問題

「リソースにアクセスできません」エラー: 特定のNotionページまたはデータベースを統合と共有していることを確認してください（手順2を参照）
共有メニューに統合が表示されません: ページを更新するか、ブラウザを再起動してください
機能が制限されています: Notionの統合設定で適切な機能が有効になっていることを確認してください

特徴

公式SDKによる完全なNotion APIサポート
シームレスなAI統合を実現するMCP準拠
Notionのあらゆる操作のための包括的なツール
詳細なメッセージによる堅牢なエラー処理
環境変数による簡単な設定

各ツールの詳細なドキュメントについては、ツールのドキュメントを参照してください。

ライセンス

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools