DevLog MCP

This is a stdio MCP server that publishes development logs written by AI coding agents like Codex and Claude Code to an existing Notion Blog Database. The agent is responsible for reflections and writing the content, while this server handles input validation and storage to Notion.

Requirements

• Node.js 20 or higher

• Existing Notion Blog Database

• Notion Integration connected to the Database

Related MCP server: Notion MCP Server

Installation and Build

npm install
npm test
npm run build

When running directly during development, set the environment variables in the current shell. This project does not automatically read a .env file.

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

stdio servers communicate with MCP clients via JSON-RPC, so no general instructions are printed when running in the terminal.

Notion Setup

1. Create an Internal Integration in the Notion Integrations screen.

2. Use the Integration token as NOTION_TOKEN.

3. Add the Integration via the connection menu of the existing Blog Database.

4. Find the Database ID in the Database URL and use it as NOTION_DATABASE_ID.

The database property names and types must be as follows.

If the names passed to the Select, Multi-select, and Status options of the existing Database do not exist, option creation may be restricted depending on Notion permissions and settings.

MCP Tools

The server provides a single tool: publish_dev_log.

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

The Markdown supported in the body includes headings 1~3, paragraphs, ordered/unordered lists, fenced code blocks, and horizontal rules.

An example call input is as follows.

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

Connecting to Codex

First, register the build result based on an absolute path.

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

Check the registration status with the following command.

codex mcp list

Connecting to Claude Code

Register as a project-scope MCP server.

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

Check the registration status with the following command.

claude mcp list

After connecting, you can ask the agent: Organize today's development work into a log and publish it using publish_dev_log.