@notionhq/notion-mcp-server 1.9.0 → 2.0.0

package/src/openapi-mcp-server/client/__tests__/http-client-upload.test.ts

@@ -81,8 +81,8 @@ describe('HttpClient File Upload', () => {
     const mockFormDataHeaders = { 'content-type': 'multipart/form-data; boundary=---123' }
 
     vi.mocked(fs.createReadStream).mockReturnValue(mockFileStream as any)
-    vi.mocked(FormData.prototype.append).mockImplementation(() => {})
-    vi.mocked(FormData.prototype.getHeaders).mockReturnValue(mockFormDataHeaders)
+    vi.spyOn(FormData.prototype, 'append').mockImplementation(() => {})
+    vi.spyOn(FormData.prototype, 'getHeaders').mockReturnValue(mockFormDataHeaders)
 
     const uploadPath = mockOpenApiSpec.paths['/upload']
     if (!uploadPath?.post) {
@@ -135,8 +135,8 @@ describe('HttpClient File Upload', () => {
     vi.mocked(fs.createReadStream)
       .mockReturnValueOnce(mockFileStream1 as any)
       .mockReturnValueOnce(mockFileStream2 as any)
-    vi.mocked(FormData.prototype.append).mockImplementation(() => {})
-    vi.mocked(FormData.prototype.getHeaders).mockReturnValue(mockFormDataHeaders)
+    vi.spyOn(FormData.prototype, 'append').mockImplementation(() => {})
+    vi.spyOn(FormData.prototype, 'getHeaders').mockReturnValue(mockFormDataHeaders)
 
     const operation: OpenAPIV3.OperationObject = {
       operationId: 'uploadFile',

package/src/openapi-mcp-server/client/__tests__/http-client.integration.test.ts

@@ -1,10 +1,8 @@
-import { describe, it, expect, beforeAll, afterAll } from 'vitest'
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
 import { HttpClient } from '../http-client'
-import type express from 'express'
-//@ts-ignore
-import { createPetstoreServer } from '../../../examples/petstore-server.cjs'
+import express from 'express'
 import type { OpenAPIV3 } from 'openapi-types'
-import axios from 'axios'
+import type { Server } from 'http'
 
 interface Pet {
   id: number
@@ -14,20 +12,132 @@ interface Pet {
   status: 'available' | 'pending' | 'sold'
 }
 
+// Simple in-memory pet store
+let pets: Pet[] = []
+let nextId = 1
+
+// Initialize/reset pets data
+function resetPets() {
+  pets = [
+    { id: 1, name: 'Fluffy', species: 'Cat', age: 3, status: 'available' },
+    { id: 2, name: 'Max', species: 'Dog', age: 5, status: 'available' },
+    { id: 3, name: 'Tweety', species: 'Bird', age: 1, status: 'sold' },
+  ]
+  nextId = 4
+}
+
+function createTestServer(port: number): Server {
+  const app = express()
+  app.use(express.json())
+
+  // GET /pets - List all pets
+  app.get('/pets', (req, res) => {
+    const status = req.query.status
+    const filtered = status ? pets.filter((p) => p.status === status) : pets
+    res.json(filtered)
+  })
+
+  // POST /pets - Create a pet
+  app.post('/pets', (req, res) => {
+    const newPet: Pet = {
+      id: nextId++,
+      name: req.body.name,
+      species: req.body.species,
+      age: req.body.age,
+      status: 'available',
+    }
+    pets.push(newPet)
+    res.status(201).json(newPet)
+  })
+
+  // GET /pets/:id - Get a pet by ID
+  app.get('/pets/:id', (req: any, res: any) => {
+    const pet = pets.find((p) => p.id === Number(req.params.id))
+    if (!pet) {
+      return res.status(404).json({ error: 'Pet not found' })
+    }
+    res.json(pet)
+  })
+
+  // PUT /pets/:id - Update a pet
+  app.put('/pets/:id', (req: any, res: any) => {
+    const pet = pets.find((p) => p.id === Number(req.params.id))
+    if (!pet) {
+      return res.status(404).json({ error: 'Pet not found' })
+    }
+    if (req.body.status) pet.status = req.body.status
+    res.json(pet)
+  })
+
+  // DELETE /pets/:id - Delete a pet
+  app.delete('/pets/:id', (req: any, res: any) => {
+    const index = pets.findIndex((p) => p.id === Number(req.params.id))
+    if (index === -1) {
+      return res.status(404).json({ error: 'Pet not found' })
+    }
+    pets.splice(index, 1)
+    res.status(204).send()
+  })
+
+  return app.listen(port)
+}
+
 describe('HttpClient Integration Tests', () => {
-  const PORT = 3456
-  const BASE_URL = `http://localhost:${PORT}`
-  let server: ReturnType<typeof express>
+  let PORT: number
+  let BASE_URL: string
+  let server: Server
   let openApiSpec: OpenAPIV3.Document
   let client: HttpClient
 
-  beforeAll(async () => {
-    // Start the petstore server
-    server = createPetstoreServer(PORT) as unknown as express.Express
+  beforeEach(async () => {
+    // Use a random port to avoid conflicts
+    PORT = 3000 + Math.floor(Math.random() * 1000)
+    BASE_URL = `http://localhost:${PORT}`
 
-    // Fetch the OpenAPI spec from the server
-    const response = await axios.get(`${BASE_URL}/openapi.json`)
-    openApiSpec = response.data
+    // Initialize pets data
+    resetPets()
+
+    // Start the test server
+    server = createTestServer(PORT)
+
+    // Create a minimal OpenAPI spec for the test server
+    openApiSpec = {
+      openapi: '3.0.0',
+      info: { title: 'Pet Store API', version: '1.0.0' },
+      servers: [{ url: BASE_URL }],
+      paths: {
+        '/pets': {
+          get: {
+            operationId: 'listPets',
+            parameters: [{ name: 'status', in: 'query', schema: { type: 'string' } }],
+            responses: { '200': { description: 'Success' } },
+          },
+          post: {
+            operationId: 'createPet',
+            requestBody: { content: { 'application/json': { schema: { type: 'object' } } } },
+            responses: { '201': { description: 'Created' } },
+          },
+        },
+        '/pets/{id}': {
+          get: {
+            operationId: 'getPet',
+            parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'integer' } }],
+            responses: { '200': { description: 'Success' }, '404': { description: 'Not found' } },
+          },
+          put: {
+            operationId: 'updatePet',
+            parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'integer' } }],
+            requestBody: { content: { 'application/json': { schema: { type: 'object' } } } },
+            responses: { '200': { description: 'Success' }, '404': { description: 'Not found' } },
+          },
+          delete: {
+            operationId: 'deletePet',
+            parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'integer' } }],
+            responses: { '204': { description: 'Deleted' }, '404': { description: 'Not found' } },
+          },
+        },
+      },
+    }
 
     // Create HTTP client
     client = new HttpClient(
@@ -41,8 +151,7 @@ describe('HttpClient Integration Tests', () => {
     )
   })
 
-  afterAll(() => {
-    //@ts-expect-error
+  afterEach(async () => {
     server.close()
   })
 

package/src/openapi-mcp-server/client/http-client.ts

@@ -177,7 +177,14 @@ export class HttpClient {
       }
     } catch (error: any) {
       if (error.response) {
-        console.error('Error in http client', error)
+        // Only log errors in non-test environments to keep test output clean
+        if (process.env.NODE_ENV !== 'test') {
+          console.error('Error in http client', {
+            status: error.response.status,
+            statusText: error.response.statusText,
+            data: error.response.data,
+          })
+        }
         const headers = new Headers()
         Object.entries(error.response.headers).forEach(([key, value]) => {
           if (value) headers.append(key, value.toString())

package/src/openapi-mcp-server/mcp/__tests__/proxy.test.ts

@@ -231,7 +231,7 @@ describe('MCPProxy', () => {
     })
 
     it('should return empty object and warn on invalid JSON', () => {
-      const consoleSpy = vi.spyOn(console, 'warn')
+      const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
       process.env.OPENAPI_MCP_HEADERS = 'invalid json'
 
       const proxy = new MCPProxy('test-proxy', mockOpenApiSpec)
@@ -242,10 +242,11 @@ describe('MCPProxy', () => {
         expect.anything(),
       )
       expect(consoleSpy).toHaveBeenCalledWith('Failed to parse OPENAPI_MCP_HEADERS environment variable:', expect.any(Error))
+      consoleSpy.mockRestore()
     })
 
     it('should return empty object and warn on non-object JSON', () => {
-      const consoleSpy = vi.spyOn(console, 'warn')
+      const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => {})
       process.env.OPENAPI_MCP_HEADERS = '"string"'
 
       const proxy = new MCPProxy('test-proxy', mockOpenApiSpec)
@@ -256,6 +257,7 @@ describe('MCPProxy', () => {
         expect.anything(),
       )
       expect(consoleSpy).toHaveBeenCalledWith('OPENAPI_MCP_HEADERS environment variable must be a JSON object, got:', 'string')
+      consoleSpy.mockRestore()
     })
 
     it('should use NOTION_TOKEN when OPENAPI_MCP_HEADERS is not set', () => {
@@ -267,7 +269,7 @@ describe('MCPProxy', () => {
         expect.objectContaining({
           headers: {
             'Authorization': 'Bearer ntn_test_token_123',
-            'Notion-Version': '2022-06-28'
+            'Notion-Version': '2025-09-03'
           },
         }),
         expect.anything(),
@@ -315,7 +317,7 @@ describe('MCPProxy', () => {
         expect.objectContaining({
           headers: {
             'Authorization': 'Bearer ntn_test_token_123',
-            'Notion-Version': '2022-06-28'
+            'Notion-Version': '2025-09-03'
           },
         }),
         expect.anything(),

package/src/openapi-mcp-server/mcp/proxy.ts

@@ -147,7 +147,7 @@ export class MCPProxy {
     if (notionToken) {
       return {
         'Authorization': `Bearer ${notionToken}`,
-        'Notion-Version': '2022-06-28'
+        'Notion-Version': '2025-09-03'
       }
     }
 

package/src/openapi-mcp-server/openapi/parser.ts

@@ -185,7 +185,8 @@ export class OpenAPIToMCPConverter {
         if (mcpMethod) {
           const uniqueName = this.ensureUniqueName(mcpMethod.name)
           mcpMethod.name = uniqueName
-          mcpMethod.description = this.getDescription(operation.summary || operation.description || '')
+          // Apply description prefix to the already-built description (which includes error responses)
+          mcpMethod.description = this.getDescription(mcpMethod.description)
           tools[apiName]!.methods.push(mcpMethod)
           openApiLookup[apiName + '-' + uniqueName] = { ...operation, method, path }
           zip[apiName + '-' + uniqueName] = { openApi: { ...operation, method, path }, mcp: mcpMethod }
@@ -519,6 +520,10 @@ export class OpenAPIToMCPConverter {
   }
 
   private getDescription(description: string): string {
-    return "Notion | " + description
+    // Only add "Notion | " prefix for the Notion API
+    if (this.openApiSpec.info.title === 'Notion API') {
+      return "Notion | " + description
+    }
+    return description
   }
 }

package/smithery.yaml

@@ -1,38 +0,0 @@
-# Smithery configuration file: https://smithery.ai/docs/build/project-config
-
-startCommand:
-  type: stdio
-  commandFunction:
-    # A JS function that produces the CLI command based on the given config to start the MCP on stdio.
-    |-
-    (config) => {
-      const env = {};
-      if (config.notionToken) {
-        env.NOTION_TOKEN = config.notionToken;
-      } else if (config.openapiMcpHeaders) {
-        env.OPENAPI_MCP_HEADERS = config.openapiMcpHeaders;
-      }
-      if (config.baseUrl) env.BASE_URL = config.baseUrl;
-      return { command: 'notion-mcp-server', args: [], env };
-    }
-  configSchema:
-    # JSON Schema defining the configuration options for the MCP.
-    type: object
-    anyOf:
-      - required: [notionToken]
-      - required: [openapiMcpHeaders]
-    properties:
-      notionToken:
-        type: string
-        description: Notion integration token (recommended)
-      openapiMcpHeaders:
-        type: string
-        default: "{}"
-        description: JSON string for HTTP headers, must include Authorization and
-          Notion-Version (alternative to notionToken)
-      baseUrl:
-        type: string
-        description: Optional override for Notion API base URL
-  exampleConfig:
-    notionToken: 'ntn_abcdef'
-    baseUrl: https://api.notion.com