Notion AI Chatbot + MCP Server

A sellable AI chatbot and MCP server that supercharges any Notion workspace. Bundle it with your Notion templates and agents to drive more sales — customers get an AI assistant that talks to their Notion data.

What This Does

Two products in one:

1. Web Chatbot — Beautiful chat UI where users talk to their Notion workspace

2. MCP Server — Connect your Notion agents (like AGENT ZERO) to AI-powered tools via the Custom MCP server dialog

Related MCP server: Notion MCP Server

Features

Notion Tools (read/write your workspace)

• Search across all pages and databases

• Query databases with filters and sorts

• Create new pages/rows in any database

• Update existing page properties

• Read full page content

AI-Powered Tools (what makes this valuable)

• Chat with AI — Multi-turn conversations with memory

• Summarize Pages — AI summaries (brief, detailed, or bullets)

• Generate Content — Blog posts, reports, emails, descriptions

• Analyze Databases — Ask questions about your data, get insights

• Smart Search — Search + AI summarization of results

• Draft from Template — Generate meeting notes, project briefs, SOPs, proposals

Quick Start

1. Get your API keys

• Notion Integration Token: notion.so/my-integrations

• Claude API Key: console.anthropic.com

2. Share databases with your integration

In Notion: open each database → "..." menu → "Connections" → Add your integration.

3. Configure

cp .env.example .env

Edit .env:

ANTHROPIC_API_KEY=sk-ant-your-key
NOTION_API_KEY=ntn_your-key
PORT=3000
BOT_NAME=My Notion Assistant

4. Install & Run

npm install
npm start

You'll see:

  ✦ My Notion Assistant is running!

  Chat UI:    http://localhost:3000
  MCP Server: http://localhost:3000/mcp

Connecting to Your Notion Agent

This is the key feature — connect your custom Notion agent to this MCP server.

Step 1: Deploy your server

Deploy to any hosting provider (see Deployment section) so you have a public URL like https://your-app.railway.app.

Step 2: Connect in Notion

1. Open your Notion agent (e.g., AGENT ZERO)

2. Click "Add connection" → "+ Add custom MCP"

3. Enter your MCP Server URL:

https://your-app.railway.app/mcp

4. Click Connect

Step 3: Your agent now has superpowers

Your Notion agent can now:

• Have AI conversations via chat_with_ai

• Summarize any page via summarize_page

• Generate content via generate_content

• Analyze database data via analyze_database

• Smart search with AI summaries via smart_search

• Draft documents from templates via draft_from_template

• Plus all Notion CRUD tools (search, query, create, update)

Customization

Bot personality

Edit prompts/system.md to customize the AI's behavior and tone.

Branding

Edit CSS custom properties in public/index.html:

:root {
  --primary: #000000;        /* Your brand color */
  --accent: #2563eb;         /* Accent color */
}

Bot name

Change BOT_NAME in your .env file.

All 14 MCP Tools

Using with Claude Desktop / Claude Code

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "notion-assistant": {
      "command": "node",
      "args": ["path/to/notion-chatbot/server.js", "--mcp-stdio"],
      "env": {
        "NOTION_API_KEY": "ntn_your-key",
        "ANTHROPIC_API_KEY": "sk-ant-your-key"
      }
    }
  }
}

Claude Code

Add to your .claude/settings.json:

{
  "mcpServers": {
    "notion-assistant": {
      "command": "node",
      "args": ["path/to/notion-chatbot/server.js", "--mcp-stdio"],
      "env": {
        "NOTION_API_KEY": "ntn_your-key",
        "ANTHROPIC_API_KEY": "sk-ant-your-key"
      }
    }
  }
}

Deployment

For your Notion agent to connect, the MCP server needs a public URL.

Example: Deploy to Railway

npm i -g @railway/cli
railway login
railway init
railway up

Copy the URL and paste it into your Notion agent's MCP server field.

API Endpoints

License

MIT