{"id":18794,"library":"slite-mcp-server","title":"Slite MCP Server","description":"A Model Context Protocol server that integrates Slite's knowledge management capabilities with AI models supporting function calling through MCP. Version 1.3.0 enables AI assistants to search notes, ask questions, retrieve note details, and create notes via tools like search-notes, ask-slite, get-note, get-note-children, and create-note. Unlike direct API integration, MCP provides a standardized protocol for tool discovery and invocation. The package ships TypeScript types and is designed for use with MCP-compatible AI clients (e.g., Claude). Features include optional filtering, pagination, content formatting, and environment variable configuration.","status":"active","version":"1.3.0","language":"javascript","source_language":"en","source_url":null,"tags":["javascript","slite","mcp","llm","nodejs","client","search","typescript"],"install":[{"cmd":"npm install slite-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add slite-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add slite-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Core MCP SDK for server implementation and tool registration","package":"@modelcontextprotocol/sdk","optional":false}],"imports":[{"note":"Package is ESM-only; CommonJS require will fail. Use dynamic import() if needed in CJS project.","wrong":"const SliteMcpServer = require('slite-mcp-server')","symbol":"SliteMcpServer","correct":"import { SliteMcpServer } from 'slite-mcp-server'"},{"note":"runServer is a named export, not a default export.","wrong":"import runServer from 'slite-mcp-server'","symbol":"runServer","correct":"import { runServer } from 'slite-mcp-server'"}],"quickstart":{"code":"import { SliteMcpServer } from 'slite-mcp-server';\n\nconst server = new SliteMcpServer({\n  apiKey: process.env.SLITE_API_KEY ?? ''\n});\n\nawait server.start();\n\n// The server exposes tools: search-notes, ask-slite, get-note, get-note-children, create-note\n// Use an MCP client to invoke them.\n\n// Example: searching notes\nconst searchResult = await server.callTool('search-notes', {\n  query: 'MCP integration',\n  page: 1,\n  hitsPerPage: 10\n});\nconsole.log(searchResult);","lang":"typescript","description":"Shows initializing a SliteMcpServer with an API key, starting it, and calling the search-notes tool as an example."},"warnings":[{"fix":"Ensure SLITE_API_KEY is set in environment or provided via CLI option.","message":"API key is required: either pass via --api-key CLI argument or set SLITE_API_KEY environment variable. Missing key causes immediate runtime error.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Always provide at least one of markdown or html when calling create-note.","message":"The create-note tool requires either markdown or html parameter; both cannot be omitted. Mistake leads to validation error.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Specify page and hitsPerPage explicitly to control pagination.","message":"Search results pagination: page and hitsPerPage are optional but if omitted, defaults may lead to incomplete results.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"export SLITE_API_KEY=your_key_here or pass --api-key=your_key_here when running npx.","cause":"The SLITE_API_KEY environment variable is not set and no --api-key argument was provided.","error":"Error: Missing required parameter: apiKey"},{"fix":"Ensure await server.start() is called before any tool invocation.","cause":"Calling server.callTool before server.start() has completed (common async mistake).","error":"TypeError: Cannot read properties of undefined (reading 'callTool')"},{"fix":"Provide either markdown (string) or html (string) parameter when calling create-note.","cause":"Both markdown and html were omitted in a create-note call.","error":"ValidationError: Either markdown or html must be provided"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}