@m2ai-mcp/notion-mcp 0.1.0

package/dist/utils/notion-client.js

@@ -0,0 +1,111 @@
+/**
+ * Notion API Client
+ * Handles all HTTP communication with Notion API
+ */
+const NOTION_API_BASE = 'https://api.notion.com/v1';
+const NOTION_VERSION = '2022-06-28';
+export class NotionClient {
+    apiKey;
+    lastRequestTime = 0;
+    rateLimitConfig = {
+        requestsPerSecond: 3,
+        minDelayMs: 334 // ~3 requests per second
+    };
+    constructor(config) {
+        this.apiKey = config.apiKey;
+    }
+    async rateLimit() {
+        const now = Date.now();
+        const timeSinceLastRequest = now - this.lastRequestTime;
+        if (timeSinceLastRequest < this.rateLimitConfig.minDelayMs) {
+            const delay = this.rateLimitConfig.minDelayMs - timeSinceLastRequest;
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+        this.lastRequestTime = Date.now();
+    }
+    getHeaders() {
+        return {
+            'Authorization': `Bearer ${this.apiKey}`,
+            'Notion-Version': NOTION_VERSION,
+            'Content-Type': 'application/json'
+        };
+    }
+    async request(method, endpoint, body) {
+        await this.rateLimit();
+        const url = `${NOTION_API_BASE}${endpoint}`;
+        try {
+            const options = {
+                method,
+                headers: this.getHeaders()
+            };
+            if (body && (method === 'POST' || method === 'PATCH')) {
+                options.body = JSON.stringify(body);
+            }
+            const response = await fetch(url, options);
+            const data = await response.json();
+            if (!response.ok) {
+                return {
+                    success: false,
+                    error: data.message || `HTTP ${response.status}: ${response.statusText}`,
+                    status: response.status
+                };
+            }
+            return {
+                success: true,
+                data: data,
+                status: response.status
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred'
+            };
+        }
+    }
+    async get(endpoint) {
+        return this.request('GET', endpoint);
+    }
+    async post(endpoint, body) {
+        return this.request('POST', endpoint, body);
+    }
+    async patch(endpoint, body) {
+        return this.request('PATCH', endpoint, body);
+    }
+    async delete(endpoint) {
+        return this.request('DELETE', endpoint);
+    }
+}
+// Helper to format ID with dashes
+function formatWithDashes(id) {
+    const clean = id.toLowerCase().replace(/-/g, '');
+    return clean.replace(/([a-f0-9]{8})([a-f0-9]{4})([a-f0-9]{4})([a-f0-9]{4})([a-f0-9]{12})/, '$1-$2-$3-$4-$5');
+}
+// Extract page/database ID from URL if provided
+export function extractNotionId(input) {
+    // If it's already a UUID format (with or without dashes)
+    const uuidPattern = /^[a-f0-9]{8}-?[a-f0-9]{4}-?[a-f0-9]{4}-?[a-f0-9]{4}-?[a-f0-9]{12}$/i;
+    if (uuidPattern.test(input)) {
+        return formatWithDashes(input);
+    }
+    // Check if it's just a 32-char hex string
+    if (/^[a-f0-9]{32}$/i.test(input)) {
+        return formatWithDashes(input);
+    }
+    // Try to extract ID from Notion URL - look for 32 hex chars at end of path
+    // Pattern: matches ID that appears after a dash following text (like "Page-Title-abc123...")
+    const urlWithTitlePattern = /[/-]([a-f0-9]{32})(?:\?|$|#)/i;
+    const urlMatch = input.match(urlWithTitlePattern);
+    if (urlMatch) {
+        return formatWithDashes(urlMatch[1]);
+    }
+    // Try pattern with dashes in URL (like /12345678-90ab-cdef-1234-567890abcdef)
+    const urlPatternDashes = /([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})/i;
+    const dashMatch = input.match(urlPatternDashes);
+    if (dashMatch) {
+        return formatWithDashes(dashMatch[1]);
+    }
+    // Return as-is if no pattern matches (will fail at API level)
+    return input;
+}
+//# sourceMappingURL=notion-client.js.map

package/dist/utils/notion-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notion-client.js","sourceRoot":"","sources":["../../src/utils/notion-client.ts"],"names":[],"mappings":"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"}

package/dist/utils/types.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Notion API Types
+ */
+export interface NotionUser {
+    object: 'user';
+    id: string;
+    type?: 'person' | 'bot';
+    name?: string;
+    avatar_url?: string | null;
+    person?: {
+        email?: string;
+    };
+}
+export interface NotionParent {
+    type: 'database_id' | 'page_id' | 'workspace';
+    database_id?: string;
+    page_id?: string;
+    workspace?: boolean;
+}
+export interface NotionRichTextItem {
+    type: 'text' | 'mention' | 'equation';
+    text?: {
+        content: string;
+        link?: {
+            url: string;
+        } | null;
+    };
+    annotations?: {
+        bold: boolean;
+        italic: boolean;
+        strikethrough: boolean;
+        underline: boolean;
+        code: boolean;
+        color: string;
+    };
+    plain_text?: string;
+    href?: string | null;
+}
+export interface NotionPage {
+    object: 'page';
+    id: string;
+    created_time: string;
+    last_edited_time: string;
+    created_by: NotionUser;
+    last_edited_by: NotionUser;
+    parent: NotionParent;
+    archived: boolean;
+    properties: Record<string, NotionProperty>;
+    url: string;
+    icon?: NotionIcon | null;
+    cover?: NotionFile | null;
+}
+export interface NotionIcon {
+    type: 'emoji' | 'external' | 'file';
+    emoji?: string;
+    external?: {
+        url: string;
+    };
+    file?: {
+        url: string;
+    };
+}
+export interface NotionFile {
+    type: 'external' | 'file';
+    external?: {
+        url: string;
+    };
+    file?: {
+        url: string;
+        expiry_time: string;
+    };
+}
+export interface NotionProperty {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+}
+export interface TitleProperty extends NotionProperty {
+    type: 'title';
+    title: NotionRichTextItem[];
+}
+export interface RichTextProperty extends NotionProperty {
+    type: 'rich_text';
+    rich_text: NotionRichTextItem[];
+}
+export interface NumberProperty extends NotionProperty {
+    type: 'number';
+    number: number | null;
+}
+export interface SelectProperty extends NotionProperty {
+    type: 'select';
+    select: {
+        id: string;
+        name: string;
+        color: string;
+    } | null;
+}
+export interface MultiSelectProperty extends NotionProperty {
+    type: 'multi_select';
+    multi_select: {
+        id: string;
+        name: string;
+        color: string;
+    }[];
+}
+export interface DateProperty extends NotionProperty {
+    type: 'date';
+    date: {
+        start: string;
+        end?: string | null;
+        time_zone?: string | null;
+    } | null;
+}
+export interface CheckboxProperty extends NotionProperty {
+    type: 'checkbox';
+    checkbox: boolean;
+}
+export interface UrlProperty extends NotionProperty {
+    type: 'url';
+    url: string | null;
+}
+export interface EmailProperty extends NotionProperty {
+    type: 'email';
+    email: string | null;
+}
+export interface PhoneProperty extends NotionProperty {
+    type: 'phone_number';
+    phone_number: string | null;
+}
+export interface PeopleProperty extends NotionProperty {
+    type: 'people';
+    people: NotionUser[];
+}
+export interface NotionDatabase {
+    object: 'database';
+    id: string;
+    created_time: string;
+    last_edited_time: string;
+    title: NotionRichTextItem[];
+    description: NotionRichTextItem[];
+    properties: Record<string, DatabaseProperty>;
+    parent: NotionParent;
+    url: string;
+    archived: boolean;
+    is_inline: boolean;
+}
+export interface DatabaseProperty {
+    id: string;
+    name: string;
+    type: string;
+    [key: string]: unknown;
+}
+export interface NotionBlock {
+    object: 'block';
+    id: string;
+    parent: NotionParent;
+    type: string;
+    created_time: string;
+    last_edited_time: string;
+    created_by: NotionUser;
+    last_edited_by: NotionUser;
+    has_children: boolean;
+    archived: boolean;
+    [key: string]: unknown;
+}
+export interface SearchRequest {
+    query?: string;
+    filter?: {
+        value: 'page' | 'database';
+        property: 'object';
+    };
+    sort?: {
+        direction: 'ascending' | 'descending';
+        timestamp: 'last_edited_time';
+    };
+    start_cursor?: string;
+    page_size?: number;
+}
+export interface SearchResponse {
+    object: 'list';
+    results: (NotionPage | NotionDatabase)[];
+    next_cursor: string | null;
+    has_more: boolean;
+}
+export interface DatabaseQueryRequest {
+    filter?: NotionFilter;
+    sorts?: NotionSort[];
+    start_cursor?: string;
+    page_size?: number;
+}
+export interface NotionFilter {
+    and?: NotionFilter[];
+    or?: NotionFilter[];
+    property?: string;
+    [key: string]: unknown;
+}
+export interface NotionSort {
+    property?: string;
+    timestamp?: 'created_time' | 'last_edited_time';
+    direction: 'ascending' | 'descending';
+}
+export interface PaginatedResponse<T> {
+    object: 'list';
+    results: T[];
+    next_cursor: string | null;
+    has_more: boolean;
+}
+export interface UsersListResponse extends PaginatedResponse<NotionUser> {
+}
+export declare function getPageTitle(page: NotionPage): string;
+export declare function getDatabaseTitle(database: NotionDatabase): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/types.js

@@ -0,0 +1,18 @@
+/**
+ * Notion API Types
+ */
+// Helper to extract title from page
+export function getPageTitle(page) {
+    for (const [, prop] of Object.entries(page.properties)) {
+        if (prop.type === 'title') {
+            const titleProp = prop;
+            return titleProp.title.map(t => t.plain_text || t.text?.content || '').join('');
+        }
+    }
+    return 'Untitled';
+}
+// Helper to extract title from database
+export function getDatabaseTitle(database) {
+    return database.title.map(t => t.plain_text || t.text?.content || '').join('') || 'Untitled';
+}
+//# sourceMappingURL=types.js.map

package/dist/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/utils/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA4NH,oCAAoC;AACpC,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,IAAqB,CAAC;YACxC,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,gBAAgB,CAAC,QAAwB;IACvD,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,UAAU,CAAC;AAC/F,CAAC"}

package/jest.config.cjs

@@ -0,0 +1,33 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/tests'],
+  testMatch: ['**/*.test.ts'],
+  moduleFileExtensions: ['ts', 'js', 'json'],
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1'
+  },
+  transform: {
+    '^.+\\.tsx?$': ['ts-jest', {
+      useESM: false,
+      tsconfig: {
+        module: 'commonjs',
+        moduleResolution: 'node'
+      }
+    }]
+  },
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+    '!src/index.ts'
+  ],
+  coverageThreshold: {
+    global: {
+      branches: 70,
+      functions: 70,
+      lines: 70,
+      statements: 70
+    }
+  }
+};

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@m2ai-mcp/notion-mcp",
+  "version": "0.1.0",
+  "description": "Notion Integration MCP server providing AI assistants with full access to Notion workspaces",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "notion-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src --ext .ts",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "notion",
+    "model-context-protocol",
+    "ai",
+    "claude"
+  ],
+  "author": "Me, Myself Plus AI LLC",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/m2ai-mcp-servers/notion-mcp.git"
+  },
+  "homepage": "https://github.com/m2ai-mcp-servers/notion-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/m2ai-mcp-servers/notion-mcp/issues"
+  },
+  "mcpName": "io.github.m2ai-mcp-servers/notion-mcp",
+  "type": "module",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/server.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://registry.modelcontextprotocol.io/schemas/server.json",
+  "name": "io.github.m2ai-mcp-servers/notion-mcp",
+  "displayName": "Notion MCP",
+  "version": "0.1.0",
+  "description": "Notion Integration MCP server providing AI assistants with full access to Notion workspaces. Enables Claude to search, read, create, and update pages, databases, and blocks.",
+  "author": {
+    "name": "Me, Myself Plus AI LLC"
+  },
+  "license": "MIT",
+  "repository": "https://github.com/m2ai-mcp-servers/notion-mcp",
+  "homepage": "https://github.com/m2ai-mcp-servers/notion-mcp#readme",
+  "runtime": "node",
+  "installation": {
+    "npm": {
+      "package": "@m2ai-mcp/notion-mcp"
+    }
+  },
+  "configuration": {
+    "required": [
+      {
+        "name": "NOTION_API_KEY",
+        "description": "Notion Internal Integration Token from https://www.notion.so/my-integrations"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "search",
+      "description": "Search across all pages and databases by keyword or title"
+    },
+    {
+      "name": "get_page",
+      "description": "Retrieve a page's properties and metadata"
+    },
+    {
+      "name": "create_page",
+      "description": "Create a new page in a database or as child of another page"
+    },
+    {
+      "name": "update_page",
+      "description": "Update a page's properties (not content blocks)"
+    },
+    {
+      "name": "get_page_content",
+      "description": "Retrieve all content blocks from a page"
+    },
+    {
+      "name": "append_blocks",
+      "description": "Add new content blocks to a page (supports markdown)"
+    },
+    {
+      "name": "update_block",
+      "description": "Update an existing block's content"
+    },
+    {
+      "name": "delete_block",
+      "description": "Delete (archive) a block"
+    },
+    {
+      "name": "get_database",
+      "description": "Retrieve database schema and properties"
+    },
+    {
+      "name": "query_database",
+      "description": "Query a database with filters and sorts"
+    },
+    {
+      "name": "create_database",
+      "description": "Create a new database as child of a page"
+    },
+    {
+      "name": "list_users",
+      "description": "List all users in the workspace"
+    },
+    {
+      "name": "get_user",
+      "description": "Get details about a specific user"
+    }
+  ],
+  "keywords": [
+    "notion",
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "claude",
+    "productivity",
+    "workspace",
+    "wiki",
+    "notes"
+  ]
+}