Slite Model Context Protocol

This package provides a Model Context Protocol 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:

npx -y slite-mcp-server --api-key=YOUR_SLITE_API_KEY

Alternatively, you can set your API key as an environment variable:

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 performparentNoteId (optional): Filter to only return notes under this parent note idreviewState (optional): Filter by review state ('Verified', 'Outdated', or 'VerificationRequested')page (optional): Page number for paginationhitsPerPage (optional): Number of notes to return per pagelastEditedAfter (optional): Filter notes edited after a specific date (ISO 8601 format)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 SliteparentNoteId (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 retrieveformat (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 notecursor (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 createparentNoteId (optional): ID of the parent note (if not specified, created in personal channel)markdown (optional): Markdown content for the notehtml (optional): HTML content for the noteNote: 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 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)

{
  "mcpServers": {
    "slite": {
      "command": "npx",
      "args": ["-y", "slite-mcp-server"],
      "env": {
        "SLITE_API_KEY": "YOUR_SLITE_API_KEY"
      }
    }
  }
}

or

{
  "mcpServers": {
    "slite": {
      "command": "npx",
      "args": ["-y", "slite-mcp-server", "--api-key=YOUR_SLITE_API_KEY"]
    }
  }
}

Development

Clone the repository and install dependencies:

git clone [email protected]: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:

   npm version patch  # for bug fixes
   npm version minor  # for new features
   npm version major  # for breaking changes

2. Build the project:

   npm run build

3. Run tests and linting:

   npm run lint
   npm run test

4. Publish to npm:

   npm publish

5. Push the version tag to GitHub:

   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 file for details.