This server provides comprehensive CRUD operations and management functionality for Notion databases and pages through the Model Context Protocol, enabling integration with AI tools like Cursor and Claude.
Page (Record) Operations:
Create pages: Add new records to databases with customizable properties (title, rich text, status, dates, checkboxes, numbers, URLs, emails, phone numbers, people assignments, relations, etc.)
Retrieve pages: Get detailed information about specific pages including all properties, timestamps, and archive status
Update pages: Modify any property type on existing pages with support for all Notion property types
Delete pages: Archive records (soft delete that can be restored later)
Query pages: Search and filter records using complex criteria with AND/OR logic, multi-field sorting, and pagination for large datasets
Database Management:
List databases: Discover all accessible databases with their IDs, titles, and archive status
Get database: Retrieve detailed information including schema and property definitions
Update database: Modify database title and schema (add/modify/delete property columns)
Advanced Features:
Complex filtering with Notion's filter syntax (equals, contains, date ranges, checkbox states, etc.)
Multi-field sorting in ascending/descending order
Cursor-based pagination (up to 100 records per request)
Statistical information retrieval and batch processing
Enterprise-ready architecture built with DDD/TDD principles, TypeScript, and Docker deployment
Provides comprehensive CRUD operations for Notion databases and pages, including creating, updating, and deleting records, querying with filters and sorting, managing database schemas, and retrieving statistics from Notion workspaces.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Notion MCP Serverfind pages in my tasks database where status is 'in progress'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Notion MCP Server
Notion API連携を行うMCP（Model Context Protocol）サーバー。CursorやClaudeと連携し、NotionのデータベースへのCRUD操作を可能にします。
特徴
DDD（ドメイン駆動設計）: 保守性の高いアーキテクチャ
TDD（テスト駆動開発）: 高品質なコード
TypeScript: 型安全な実装
Notion API統合: Notion APIの全般的な機能をサポート
Docker対応: 環境構築不要で即座に利用可能
主な機能
ページ（レコード）操作
✅ ページ作成: データベースに新しいレコードを追加
✅ ページ取得: 指定したIDのレコードを取得
✅ ページ更新: レコードの各項目（プロパティ）を個別または一括更新
テキスト、セレクト、マルチセレクト、日付、チェックボックス、数値、URL、メールアドレス、電話番号、ユーザー、関連ページなど、全てのプロパティタイプに対応
✅ ページ削除: レコードをアーカイブ（削除）
✅ ページクエリ: フィルター・ソート条件でレコードを検索
データベース操作
✅ データベース取得: 指定したIDのデータベース情報を取得
✅ データベース一覧: アクセス可能なデータベースを一覧表示
✅ データベース更新: データベースのタイトルやスキーマを更新
高度な機能
🔄 ページネーション: 大量データの自動ページング処理
🔍 フィルタリング: 条件に基づく柔軟な検索
📊 ソート: 複数条件による並び替え
📈 統計情報: データベースの統計取得
アーキテクチャ
src/
├── domain/ # ドメイン層（ビジネスロジック）
│ ├── entities/ # エンティティ
│ ├── repositories/ # リポジトリインターフェース
│ ├── services/ # ドメインサービス
│ └── value-objects/ # 値オブジェクト
├── infrastructure/ # インフラ層（外部システム連携）
│ ├── notion/ # Notion APIクライアント
│ └── repositories/ # リポジトリ実装
├── application/ # アプリケーション層（ユースケース）
│ └── use-cases/ # ビジネスユースケース
├── presentation/ # プレゼンテーション層（入出力）
│ └── mcp/ # MCPサーバー実装
└── shared/ # 共有コードクイックスタート（Docker使用）🐳
最も簡単な方法はDockerを使用することです：
# Docker Hubから取得
docker pull kazuyaoda/notion-mcp:latest
# 実行
docker run -it \
-e NOTION_API_KEY=your_notion_api_key \
kazuyaoda/notion-mcp:latestまたは、スクリプトを使用：
export NOTION_API_KEY=your_notion_api_key
./scripts/docker-run.sh詳細は DOCKER.md を参照してください。
ローカル開発セットアップ
# 依存関係のインストール
npm install
# ビルド
npm run build
# テスト実行
npm test
# 開発モード
npm run dev設定
環境変数 NOTION_API_KEY にNotion APIキーを設定してください。
export NOTION_API_KEY=your_notion_api_keyCursor/Claudeでの使用方法
オプション1: Docker経由（推奨）
MCP設定ファイルに以下を追加：
{
"mcpServers": {
"notion": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"NOTION_API_KEY=your_notion_api_key",
"kazuyaoda/notion-mcp:latest"
]
}
}
}オプション2: ローカル実行
{
"mcpServers": {
"notion": {
"command": "node",
"args": ["/path/to/notion-mcp/dist/index.js"],
"env": {
"NOTION_API_KEY": "your_notion_api_key"
}
}
}
}機能
✅ ページの作成、取得、更新、削除
✅ データベースの取得と更新
✅ 高度なクエリ（フィルター、ソート、ページネーション）
✅ 統計情報の取得
✅ エラーハンドリング
ドキュメント
ARCHITECTURE.md - アーキテクチャの詳細
DOCKER.md - Docker使用ガイド
EXAMPLES.md - 使用例
INTEGRATION_TEST.md - 統合テストガイド
SECURITY.md - セキュリティガイド
QUICK_START.md - クイック公開ガイド
開発
テスト
# 全テスト実行
npm test
# カバレッジ付き
npm run test:coverage
# watch モード
npm run test:watchDockerビルド
# 基本ビルド
docker build -t notion-mcp:latest .
# マルチプラットフォームビルド
./scripts/docker-build.sh --multi-platform
# ビルドしてDocker Hubにプッシュ
./scripts/docker-build.sh --push --username kazuyaodaライセンス
MIT