DevLog MCP

Codex、Claude CodeなどのAIコーディングエージェントが作成した開発日誌を、既存のNotion Blog DBに発行するstdio MCPサーバーです。エージェントが振り返りと本文作成を担当し、このサーバーは入力検証とNotion保存のみを担当します。

要件

• Node.js 20以上

• 既存のNotion Blog Database

• Databaseに接続されたNotion Integration

Related MCP server: Notion MCP Server

インストールとビルド

npm install
npm test
npm run build

開発中に直接実行する場合は、環境変数を現在のシェルに設定します。このプロジェクトは.envファイルを自動的に読み込みません。

export NOTION_TOKEN="secret_..."
export NOTION_DATABASE_ID="..."
npm run dev

stdioサーバーはMCPクライアントとJSON-RPCで通信するため、ターミナルで実行しても一般的な案内メッセージは出力されません。

Notion設定

1. NotionのIntegrations画面でInternal Integrationを作成します。

2. Integration tokenをNOTION_TOKENとして使用します。

3. 既存のBlog Databaseの接続メニューで該当のIntegrationを追加します。

4. Database URLからDatabase IDを見つけ、NOTION_DATABASE_IDとして使用します。

Databaseのプロパティ名とタイプは以下の通りである必要があります。

既存のDatabaseのSelect、Multi-select、Statusオプションに渡した名前がない場合、Notionの権限と設定によってオプションの作成が制限される可能性があります。

MCPツール

サーバーはpublish_dev_logツールを一つ提供します。

type PublishDevLogInput = {
  title: string;
  category?: string;
  tags?: string[];
  publishedAt?: string;
  status?: "published" | "draft";
  content: string;
};

本文でサポートするMarkdownは、見出し1〜3、段落、順序付き/順序なしリスト、fenced code block、区切り線です。

呼び出し入力例は以下の通りです。

{
  "title": "DevLog MCP 첫 구현",
  "tags": ["MCP", "Notion", "TypeScript"],
  "content": "# 오늘의 작업\nNotion 발행 도구를 구현했다.\n\n## 결정\n- MCP는 저장만 담당한다.\n- 회고 작성은 코딩 에이전트가 담당한다."
}

Codex接続

まず、絶対パス基準でビルド結果を登録します。

codex mcp add devlog-mcp \
  --env NOTION_TOKEN=secret_... \
  --env NOTION_DATABASE_ID=... \
  -- node /Users/oddd/workspace/notion/devlog-mcp/dist/index.js

登録状態は次のコマンドで確認します。

codex mcp list

Claude Code接続

プロジェクトスコープのMCPサーバーとして登録します。

claude mcp add -s project devlog-mcp \
  -e NOTION_TOKEN=secret_... \
  -e NOTION_DATABASE_ID=... \
  -- node /Users/oddd/workspace/notion/devlog-mcp/dist/index.js

登録状態は次のコマンドで確認します。

claude mcp list

接続後、エージェントに今日開発した内容を日誌にまとめてpublish_dev_logで発行してと依頼できます。

devlog-mcp