Notion MCP サーバー
Notionとのシームレスな統合を実現するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、言語モデルは標準化されたツール（ページやデータベースの検索、読み取り、作成、更新ツールなど）を通じてNotionワークスペースと連携できるようになります。
🌟 主な機能
ページ操作
- 🔍 Notionワークスペースを検索する
- 📝 豊富なマークダウンコンテンツで新しいページを作成する
- 📖 ページのコンテンツをきれいなフォーマットで読み上げる
- 🔄既存のページを更新する
- 💬 コメントを追加および取得する
- 🧱 ブロックレベルの操作（更新、削除）
強化されたマークダウンサポート
- 複数の見出しレベル（H1～H3）
- 言語サポート付きのコードブロック
- チェックボックスの状態を持つインタラクティブな ToDo 項目
- 複数行をサポートするブロック引用
- 水平区切り線
- キャプション付きの画像
- ネストされた箇条書き
データベース操作
- データベースの作成と管理
- データベース項目の追加と更新
- フィルターと並べ替えを使用したクエリ
- さまざまなプロパティ タイプのサポート:
- タイトル、リッチテキスト、番号
- 選択、複数選択
- 日付、チェックボックス
- さらにもっと！
🚀 はじめに
前提条件
- Node.js (v16 以上)
- Notion APIキー
- MCP 互換クライアント (例: Claude Desktop)
インストール
- リポジトリをクローンします。
git clone https://github.com/v-3/notion-server.git
cd notion-server
- 依存関係をインストールします:
- 環境を設定します。
# 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
- サーバーを構築します。
🔧 構成
クロードデスクトップセットアップ
- 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"
}
}
}
}
- 変更を適用するには、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アクセスの設定
統合の作成
- Notionの統合をご覧ください
- 「新しい統合」をクリックします
- 権限を設定します。
- コンテンツ: 読み取り、更新、挿入
- コメント: 読む、作成する
- ユーザー情報: 読む
ページの接続
- Notionページを開く
- 「...」メニュー→「接続」をクリック
- 統合を追加する
- 必要に応じて他のページでも繰り返します
📝 使用例
ページの作成
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"
}
}
});
🤝 貢献する
貢献を歓迎します！ご協力をお願いします:
- リポジトリをフォークする
- 機能ブランチを作成する
- プルリクエストを送信する
📜 ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
🙏 謝辞
このプロジェクトはsweir1/notion-serverによって大幅に改善され、以下の更新が行われました:
- より多くのブロックタイプによるマークダウンサポートの強化
- 包括的なデータベース操作
- エラー処理とデバッグの改善
- データベース項目のプロパティ処理の改善
- よりクリーンなページ出力フォーマット
sweir1 のバージョンを使用するには、リポジトリをクローンします。
git clone https://github.com/sweir1/notion-server.git