notion-mcp-server 0.0.2 → 1.0.0

package/README.md

@@ -9,7 +9,7 @@
 
 **Notion MCP Server** is a Model Context Protocol (MCP) server implementation that enables AI assistants to interact with Notion's API. This production-ready server provides a complete set of tools and endpoints for reading, creating, and modifying Notion content through natural language interactions.
 
-> 🚧 **Active Development**: Database support is now available! If you find this project useful, please consider giving it a star - it helps me know that this work is valuable to the community and motivates further development.
+> 🚧 **Active Development**: Database support is now available! Comments and user management tools have been added. If you find this project useful, please consider giving it a star - it helps me know that this work is valuable to the community and motivates further development.
 
 <a href="https://glama.ai/mcp/servers/zrh07hteaa">
   <img width="380" height="200" src="https://glama.ai/mcp/servers/zrh07hteaa/badge" />
@@ -56,6 +56,10 @@
    - "Add bullet points to my meeting notes page"
    - "Create a new database for tracking projects"
    - "Add new entries to my task database"
+   - "Add a comment to my project page"
+   - "Show me all comments on this document"
+   - "List all users in my workspace"
+   - "Get information about a specific user"
 
 ### Cursor Integration
 
@@ -124,6 +128,8 @@ env NOTION_TOKEN=YOUR_KEY NOTION_PAGE_ID=YOUR_PAGE_ID npx -y notion-mcp-server
 - **🔄 Batch Operations** - Perform multiple operations in a single request
 - **🗑️ Archive & Restore** - Archive and restore Notion pages
 - **🔎 Search Functionality** - Search Notion pages and databases by title
+- **💬 Comments Management** - Get, create, and reply to comments on pages and discussions
+- **👥 User Management** - Retrieve workspace users and user information
 
 ## 📚 Documentation
 
@@ -190,6 +196,28 @@ Delete multiple blocks in a single operation
 ##### `batch_mixed_operations`
 Perform a mix of append, update, and delete operations in a single request
 
+#### Comment Operations
+
+##### `get_comments`
+Retrieve comments from a page or block with pagination support
+
+##### `add_page_comment`
+Add a new comment to a Notion page
+
+##### `add_discussion_comment`
+Add a comment to an existing discussion thread
+
+#### User Operations
+
+##### `get_list_users`
+Retrieve a paginated list of all users in the workspace
+
+##### `get_user`
+Get detailed information about a specific user by ID
+
+##### `get_bot_user`
+Retrieve the current bot user associated with the API token
+
 ### Available Resources
 
 The server currently does not expose any resources, focusing instead on tool-based operations.

package/build/config/index.js

@@ -1,5 +1,5 @@
 // Configuration
 export const CONFIG = {
     serverName: "notion-mcp-server",
-    serverVersion: "0.0.2",
+    serverVersion: "1.0.0",
 };

package/build/schema/comments.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { RICH_TEXT_ITEM_REQUEST_SCHEMA } from "./rich-text.js";
+// Schema for getting comments
+export const GET_COMMENTS_SCHEMA = {
+    block_id: z
+        .string()
+        .describe("The ID of the block or page to get comments from"),
+    start_cursor: z
+        .string()
+        .optional()
+        .describe("The cursor to start from for pagination"),
+    page_size: z
+        .number()
+        .optional()
+        .describe("Number of comments to return per page"),
+};
+// Schema for adding a comment to a page
+export const ADD_PAGE_COMMENT_SCHEMA = {
+    parent: z.object({
+        page_id: z.string().describe("The ID of the page to add the comment to"),
+    }),
+    rich_text: z
+        .array(RICH_TEXT_ITEM_REQUEST_SCHEMA)
+        .describe("Rich text content for the comment"),
+};
+// Schema for adding a comment to a discussion
+export const ADD_DISCUSSION_COMMENT_SCHEMA = {
+    discussion_id: z
+        .string()
+        .describe("The ID of the discussion to add the comment to"),
+    rich_text: z
+        .array(RICH_TEXT_ITEM_REQUEST_SCHEMA)
+        .describe("Rich text content for the comment"),
+};

package/build/schema/users.js

@@ -0,0 +1,13 @@
+import { z } from "zod";
+// Schema for listing users with pagination
+export const LIST_USERS_SCHEMA = {
+    start_cursor: z.string().optional().describe("Pagination cursor"),
+    page_size: z
+        .number()
+        .optional()
+        .describe("Number of users to return per page"),
+};
+// Schema for getting a single user
+export const GET_USER_SCHEMA = {
+    user_id: z.string().describe("The ID of the user to retrieve"),
+};

package/build/tools/comments.js

@@ -0,0 +1,62 @@
+import { notion } from "../services/notion.js";
+import { handleNotionError } from "../utils/error.js";
+export const registerGetCommentsTool = async (params) => {
+    try {
+        const response = await notion.comments.list(params);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Comments retrieved successfully: ${response.results.length}`,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleNotionError(error);
+    }
+};
+export const registerAddPageCommentTool = async (params) => {
+    try {
+        const response = await notion.comments.create(params);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Comment created successfully: ${response.id}`,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleNotionError(error);
+    }
+};
+export const registerAddDiscussionCommentTool = async (params) => {
+    try {
+        const response = await notion.comments.create(params);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Comment created successfully: ${response.id}`,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleNotionError(error);
+    }
+};

package/build/tools/index.js

@@ -18,6 +18,12 @@ import { createDatabase } from "./createDatabase.js";
 import { queryDatabase } from "./queryDatabase.js";
 import { updateDatabase } from "./updateDatabase.js";
 import { updatePageProperties } from "./updatePageProperties.js";
+import { registerAddDiscussionCommentTool, registerAddPageCommentTool, registerGetCommentsTool, } from "./comments.js";
+import { ADD_DISCUSSION_COMMENT_SCHEMA, ADD_PAGE_COMMENT_SCHEMA, GET_COMMENTS_SCHEMA, } from "../schema/comments.js";
+import { registerGetListUsersTool } from "./users.js";
+import { LIST_USERS_SCHEMA } from "../schema/users.js";
+import { registerGetBotUserTool, registerGetUserTool } from "./users.js";
+import { GET_USER_SCHEMA } from "../schema/users.js";
 export const registerAllTools = () => {
     server.tool("create_page", "Create a new page in Notion", CREATE_PAGE_SCHEMA, registerCreatePageTool);
     server.tool("archive_page", "Archive (trash) a Notion page", ARCHIVE_PAGE_SCHEMA, archivePage);
@@ -38,4 +44,10 @@ export const registerAllTools = () => {
     server.tool("batch_update_blocks", "Update multiple blocks in a single operation", BATCH_UPDATE_BLOCKS_SCHEMA, batchUpdateBlocks);
     server.tool("batch_delete_blocks", "Delete multiple blocks in a single operation", BATCH_DELETE_BLOCKS_SCHEMA, batchDeleteBlocks);
     server.tool("batch_mixed_operations", "Perform a mix of append, update, and delete operations in a single request", BATCH_MIXED_OPERATIONS_SCHEMA, batchMixedOperations);
+    server.tool("get_comments", "Get comments for a page or discussion", GET_COMMENTS_SCHEMA, registerGetCommentsTool);
+    server.tool("add_page_comment", "Add a comment to a page", ADD_PAGE_COMMENT_SCHEMA, registerAddPageCommentTool);
+    server.tool("add_discussion_comment", "Add a comment to a discussion", ADD_DISCUSSION_COMMENT_SCHEMA, registerAddDiscussionCommentTool);
+    server.tool("get_list_users", "Get a list of users in Notion", LIST_USERS_SCHEMA, registerGetListUsersTool);
+    server.tool("get_user", "Get a user in Notion", GET_USER_SCHEMA, registerGetUserTool);
+    server.tool("get_bot_user", "Get the bot user in Notion", {}, registerGetBotUserTool);
 };

package/build/tools/searchPage.js

@@ -4,10 +4,6 @@ export async function searchPages(params) {
     try {
         const response = await notion.search({
             query: params.query || "",
-            filter: {
-                value: "page",
-                property: "object",
-            },
             sort: params.sort,
             start_cursor: params.start_cursor,
             page_size: params.page_size || 10,

package/build/tools/users.js

@@ -0,0 +1,62 @@
+import { notion } from "../services/notion.js";
+import { handleNotionError } from "../utils/error.js";
+export const registerGetListUsersTool = async (params) => {
+    try {
+        const response = await notion.users.list(params);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Users retrieved successfully: ${response.results.length}`,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleNotionError(error);
+    }
+};
+export const registerGetUserTool = async (params) => {
+    try {
+        const response = await notion.users.retrieve(params);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `User retrieved successfully: ${response.id}`,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleNotionError(error);
+    }
+};
+export const registerGetBotUserTool = async () => {
+    try {
+        const response = await notion.users.me({});
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Bot user retrieved successfully: ${response.id}`,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify(response, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleNotionError(error);
+    }
+};

package/build/types/comments.js

@@ -0,0 +1,6 @@
+import { z } from "zod";
+import { GET_COMMENTS_SCHEMA, ADD_PAGE_COMMENT_SCHEMA, ADD_DISCUSSION_COMMENT_SCHEMA, } from "../schema/comments.js";
+// Types inferred from the schemas
+export const getCommentsSchema = z.object(GET_COMMENTS_SCHEMA);
+export const addPageCommentSchema = z.object(ADD_PAGE_COMMENT_SCHEMA);
+export const addDiscussionCommentSchema = z.object(ADD_DISCUSSION_COMMENT_SCHEMA);

package/build/types/users.js

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import { LIST_USERS_SCHEMA, GET_USER_SCHEMA } from "../schema/users.js";
+// Types inferred from schemas
+const listUsersSchema = z.object(LIST_USERS_SCHEMA);
+const getUserSchema = z.object(GET_USER_SCHEMA);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "notion-mcp-server",
-  "version": "0.0.2",
+  "version": "1.0.0",
   "type": "module",
   "bin": {
     "notion-mcp-server": "build/index.js"