@west10tech/notion-mcp 1.0.0

package/README.md

@@ -0,0 +1,120 @@
+# notion-mcp
+
+MCP server with full notion capabilities (20 endpoints)
+
+This MCP server includes the following integrations:
+
+## Available Tools
+
+This MCP server provides 20 tools across 1 integrations:
+
+### Notion Tools
+- **notion_list_databases**: ⚠️ DEPRECATED: This endpoint is deprecated by Notion API. Use the search endpoint with database filter instead.
+- **notion_get_database**: Get database by ID
+- **notion_query_database**: Query database pages
+- **notion_create_database**: Create a new database
+- **notion_update_database**: Update database properties
+- **notion_get_page**: Get page by ID
+- **notion_create_page**: Create a new page. Note: Creating pages directly in workspace root requires special permissions - use database or page parents instead.
+- **notion_update_page**: Update page properties
+- **notion_get_page_property**: Get page property by ID
+- **notion_get_block_children**: Get block children
+- **notion_append_block_children**: Append blocks to a parent block
+- **notion_get_block**: Get block by ID
+- **notion_update_block**: Update block content
+- **notion_delete_block**: Delete a block
+- **notion_list_users**: List all users
+- **notion_get_user**: Get user by ID
+- **notion_get_me**: Get current bot user
+- **notion_search**: Search pages and databases
+- **notion_create_comment**: Create a comment on a page or block
+- **notion_get_comments**: Get comments for a page or block
+
+## Installation
+
+```bash
+npm install notion-mcp-496207f7-b2cc-4edc-aa28-a31b7fb738c2
+```
+
+## Environment Setup
+
+Create a `.env` file with the following variables:
+
+```env
+NOTION_ACCESS_TOKEN=your_notion_access_token_here
+```
+
+## Usage
+
+### Running the server
+
+```bash
+# Development mode
+npm run dev
+
+# Production mode
+npm run build && npm start
+```
+
+### Using with Claude Desktop
+
+Add this to your Claude Desktop configuration:
+
+```json
+{
+  "mcpServers": {
+    "notion-mcp": {
+      "command": "npx",
+      "args": ["notion-mcp-496207f7-b2cc-4edc-aa28-a31b7fb738c2"],
+      "env": {
+        "NOTION_ACCESS_TOKEN": "your_notion_access_token_here"
+      }
+    }
+  }
+}
+```
+
+## Instructions for Fetching API Keys/Tokens
+- **COMING SOON**
+
+## Advanced Features
+
+### Request Cancellation
+
+This MCP server supports request cancellation according to the [MCP cancellation specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/utilities/cancellation). Clients can cancel in-progress requests by sending a `notifications/cancelled` message with the request ID.
+
+When a request is cancelled:
+- The server immediately stops processing the request
+- Any ongoing API calls are aborted
+- Resources are cleaned up
+- No response is sent for the cancelled request
+
+### Progress Notifications
+
+The server supports progress notifications for long-running operations according to the [MCP progress specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/utilities/progress). 
+
+To receive progress updates:
+1. Include a `progressToken` in your request metadata
+2. The server will send `notifications/progress` messages with:
+   - Current progress value
+   - Total value (when known)
+   - Human-readable status messages
+
+Progress is reported for:
+- Multi-step operations
+- Batch processing
+- Long-running API calls
+- File uploads/downloads
+
+Example progress notification:
+```json
+{
+  "method": "notifications/progress",
+  "params": {
+    "progressToken": "operation-123",
+    "progress": 45,
+    "total": 100,
+    "message": "Processing item 45 of 100..."
+  }
+}
+```

package/dist/clients/notion-client.d.ts

@@ -0,0 +1,53 @@
+import { Logger } from '../services/logger.js';
+import { RequestOptions } from '../types.js';
+export interface NotionClientConfig {
+    nOTIONACCESSTOKEN?: string;
+    timeout?: number;
+    rateLimit?: number;
+    authToken?: string;
+    logger?: Logger;
+}
+export declare class NotionClient {
+    private httpClient;
+    private config;
+    private sessionId;
+    private logger;
+    constructor(config: NotionClientConfig);
+    private setupRateLimit;
+    private resolveBaseUrl;
+    private getAuthHeaders;
+    /**
+     * Initialize the client (for OAuth clients that need initialization)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Get the session ID for this client instance
+     */
+    getSessionId(): string;
+    /**
+     * Make an authenticated request with proper headers and cancellation support
+     */
+    private makeAuthenticatedRequest;
+    private buildPath;
+    listDatabases(params: any, options?: RequestOptions): Promise<any>;
+    getDatabase(params: any, options?: RequestOptions): Promise<any>;
+    queryDatabase(params: any, options?: RequestOptions): Promise<any>;
+    createDatabase(params: any, options?: RequestOptions): Promise<any>;
+    updateDatabase(params: any, options?: RequestOptions): Promise<any>;
+    getPage(params: any, options?: RequestOptions): Promise<any>;
+    createPage(params: any, options?: RequestOptions): Promise<any>;
+    updatePage(params: any, options?: RequestOptions): Promise<any>;
+    getPageProperty(params: any, options?: RequestOptions): Promise<any>;
+    getBlockChildren(params: any, options?: RequestOptions): Promise<any>;
+    appendBlockChildren(params: any, options?: RequestOptions): Promise<any>;
+    getBlock(params: any, options?: RequestOptions): Promise<any>;
+    updateBlock(params: any, options?: RequestOptions): Promise<any>;
+    deleteBlock(params: any, options?: RequestOptions): Promise<any>;
+    listUsers(params: any, options?: RequestOptions): Promise<any>;
+    getUser(params: any, options?: RequestOptions): Promise<any>;
+    getMe(params: any, options?: RequestOptions): Promise<any>;
+    search(params: any, options?: RequestOptions): Promise<any>;
+    createComment(params: any, options?: RequestOptions): Promise<any>;
+    getComments(params: any, options?: RequestOptions): Promise<any>;
+}
+//# sourceMappingURL=notion-client.d.ts.map

package/dist/clients/notion-client.d.ts.map

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