julien-mcp-notion

Install Notion MCP for workspace integration. Use when user needs Notion API access.

Stars 163

Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/testing/julien-mcp-notion

SKILL.md

MCP Notion Installer

This skill installs the Notion MCP server into the current project.

Installation Procedure

When the user asks to install Notion MCP:

Check for existing .mcp.json in the project root
Merge configuration - Add this server to mcpServers:

json

{
  "notion": {
    "command": "cmd",
    "args": ["/c", "npx", "-y", "@suekou/mcp-notion-server"],
    "env": {
      "NOTION_API_TOKEN": "${NOTION_API_TOKEN}",
      "NOTION_MARKDOWN_CONVERSION": "${NOTION_MARKDOWN_CONVERSION}"
    }
  }
}

If .mcp.json doesn't exist, create it with the full structure:

json

{
  "mcpServers": {
    "notion": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "${NOTION_API_TOKEN}",
        "NOTION_MARKDOWN_CONVERSION": "${NOTION_MARKDOWN_CONVERSION}"
      }
    }
  }
}

Environment Variables Required

NOTION_API_TOKEN: Your Notion integration token
NOTION_MARKDOWN_CONVERSION: Set to "true" for markdown conversion

Usage After Installation

Restart Claude Code to activate the MCP server.

Example Usage

After installation, use in Claude Code:

"List all pages in my Notion workspace"
"Create a new page titled 'Meeting Notes'"

Skill Chaining

Input: User request to install Notion MCP
Output: Configured .mcp.json with notion server
Tools Used: Read, Edit, Write
Chains With: Notion Pro MCP, Notion Internal MCP

Troubleshooting

Problem	Solution
API token invalid	Create new integration at notion.so/my-integrations
Page not found	Share page with your integration in Notion
`npx` not found	Install Node.js and ensure npm is in PATH
Markdown conversion fails	Set NOTION_MARKDOWN_CONVERSION to "true"