Notion MCP Client (CLI & Library)

A lightweight, dedicated Command Line Interface (CLI) and TypeScript client for interacting directly with Notion workspaces via Model Context Protocol (MCP) servers.

Setup

1. Configure your Notion token inside server-config.json:

   {
     "command": "npx",
     "args": [
       "-y",
       "@notionhq/notion-mcp-server"
     ],
     "env": {
       "NOTION_TOKEN": "secret_your_notion_integration_token_here",
       "NOTION_API_KEY": "secret_your_notion_integration_token_here"
     }
   }

2. Build the project:

   npm run build

3. (Optional) Link as a global executable binary:

   npm link

CLI Usage

Run notion_mcp directly from terminal:

# Interactive REPL mode
notion_mcp

# List all available Notion MCP tools
notion_mcp tools

# Print bot & workspace information
notion_mcp self

# List workspace users
notion_mcp users

# Search workspace pages
notion_mcp search "my page"

# Call any Notion tool directly with JSON arguments
notion_mcp call API-post-search '{"query": "notes"}'

Programmatic Usage

Import NotionMCPClient directly in TypeScript/JavaScript projects:

import { NotionMCPClient } from "./src/MCPClient.js";

const client = new NotionMCPClient();
await client.connectToServer({
  command: "npx",
  args: ["-y", "@notionhq/notion-mcp-server"],
  env: { NOTION_TOKEN: "ntn_..." }
});

const users = await client.getUsers();
console.log(users);

await client.cleanup();