Slite Mcp Server

# Slite Model Context Protocol This package provides a [Model Context Protocol](https://modelcontextprotocol.com/) server for integrating Slite's OpenAPI functionality with AI models that support function calling through MCP. ## Installation & Usage You can run the Slite MCP server directly using npx: ```bash npx -y slite-mcp-server --api-key=YOUR_SLITE_API_KEY ``` Alternatively, you can set your API key as an environment variable: ```bash export SLITE_API_KEY=YOUR_SLITE_API_KEY npx -y slite-mcp-server ``` # Available Tools | Tool Name | Description | Parameters | | ------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `search-notes` | Searches notes in Slite based on a query | `query` (string): The search query to perform<br>`parentNoteId` (optional): Filter to only return notes under this parent note id<br>`reviewState` (optional): Filter by review state ('Verified', 'Outdated', or 'VerificationRequested')<br>`page` (optional): Page number for pagination<br>`hitsPerPage` (optional): Number of notes to return per page<br>`lastEditedAfter` (optional): Filter notes edited after a specific date (ISO 8601 format)<br>`includeArchived` (optional): Include archived notes in results (default: false) | | `ask-slite` | Asks a question to Slite and returns an answer with sources | `question` (string): The question to ask Slite<br>`parentNoteId` (optional): Filter to only search within notes under this parent note id | | `get-note` | Retrieves a specific note from Slite by its ID | `noteId` (string): The ID of the note to retrieve<br>`format` (optional): Format of the content ('md' or 'html', defaults to 'md') | | `get-note-children` | Retrieves all child notes of a specific note | `noteId` (string): The ID of the parent note<br>`cursor` (optional): Cursor for pagination when there are more than 50 children | | `create-note` | Creates a new note in Slite with optional content | `title` (string): The title of the note to create<br>`parentNoteId` (optional): ID of the parent note (if not specified, created in personal channel)<br>`markdown` (optional): Markdown content for the note<br>`html` (optional): HTML content for the note<br>**Note**: Either `markdown` or `html` must be provided | # Command Line Options | Option | Description | | ------------ | --------------------------------------------------------------- | | `--api-key` | Your Slite API key (required unless `SLITE_API_KEY` env is set) | | `--base-url` | Custom API base URL (default: `https://api.slite.com/`) | | `--help, -h` | Show help text | # Usage with Claude Add the following to your `claude_desktop_config.json`. See the [MCP documentation](https://modelcontextprotocol.io/quickstart/user) for more details. To ensure compatibility with Claude, we recommend that `npx` command be accessible within the same environment. A common location for this is `/usr/local/bin/node` (on mac) ```json { "mcpServers": { "slite": { "command": "npx", "args": ["-y", "slite-mcp-server"], "env": { "SLITE_API_KEY": "YOUR_SLITE_API_KEY" } } } } ``` or ```json { "mcpServers": { "slite": { "command": "npx", "args": ["-y", "slite-mcp-server", "--api-key=YOUR_SLITE_API_KEY"] } } } ``` ## Development Clone the repository and install dependencies: ```bash git clone git@github.com:sliteteam/slite-mcp-server.git cd slite-mcp-server npm install ``` # Available Scripts | Script | Description | | ---------------- | ---------------------------- | | `npm run build` | Build the TypeScript project | | `npm run lint` | Run ESLint | | `npm run format` | Format code with Prettier | # Publishing a New Release To publish a new version of the package to npm: 1. **Update the version number** in `package.json`: ```bash npm version patch # for bug fixes npm version minor # for new features npm version major # for breaking changes ``` 2. **Build the project**: ```bash npm run build ``` 3. **Run tests and linting**: ```bash npm run lint npm run test ``` 4. **Publish to npm**: ```bash npm publish ``` 5. **Push the version tag to GitHub**: ```bash git push && git push --tags ``` **Note**: Make sure you're logged in to npm (`npm login`) and have the necessary permissions to publish the `slite-mcp-server` package. # License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.