slite-mcp-server

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 --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

Available Tools

Tool Name	Description	Parameters
search-notes	Searches notes in Slite based on a query	query (string): The search query to perform parentNoteId (optional): Filter to only return notes under this parent note id reviewState (optional): Filter by review state ('Verified', 'Outdated', or 'VerificationRequested') page (optional): Page number for pagination hitsPerPage (optional): Number of notes to return per page lastEditedAfter (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 Slite 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 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 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 parentNoteId (optional): ID of the parent note (if not specified, created in personal channel) markdown (optional): Markdown content for the note html (optional): HTML content for the note 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 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"],
      "env": {
        "SLITE_API_KEY": "YOUR_SLITE_API_KEY"
      }
    }
  }
}

or

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

Development

Clone the repository and install dependencies:

git clone [e-mail]: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:

• 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
  

• Build the project:

  npm run build
  

• Run tests and linting:

  npm run lint
  npm run test
  

• Publish to npm:

  npm publish
  

• 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.