Kibela MCP Server

How to use

You connect an MCP client like Claude Desktop or VSCode to the Kibela MCP Server running on your machine. The server exposes a set of public MCP tools for querying notes, folders, comments, and related data. Use these tools to search Kibela notes, retrieve notes by path or URL, create or update notes, manage folders, and add comments. You can also run prompts to review or explore notes. Configure your client to point at the Kibela origin and supply your Kibela access token to authorize requests.

How to install

Prerequisites you need before starting: Docker is installed and running. You must have a Kibela access token issued. You also need an MCP client installed to interact with the server.

Choose one of the following runtime methods to start the Kibela MCP Server.

{
  "mcpServers": {
    "kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "KIBELA_ORIGIN",
        "-e",
        "KIBELA_ACCESS_TOKEN",
        "ghcr.io/kibela/kibela-mcp-server"
      ],
      "env": {
        "KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
        "KIBELA_ACCESS_TOKEN": "***"
      }
    }
  }
}

If you prefer not to use Docker, set the script path as the execution command and ensure the path is absolute.

{
  "mcpServers": {
    "kibela": {
      "command": "/path/to/kibela-mcp-server/bin/cli.mjs",
      "env": {
        "KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
        "KIBELA_ACCESS_TOKEN": "***"
      }
    }
  }
}

Configuration and customization

You can customize tool descriptions and prompts by providing a JSON file and mounting it into the container. Create a file with your new tool and prompt descriptions, then mount it at the expected path inside the container so the server can read the customization at startup.

{
  "tools": {
    "search_kibela_note": {
      "description": "New description"
    }
  },
  "prompts": {
    "review": {
      "prompt": "New review prompt"
    }
  }
}

To apply the customization with Docker, mount the configuration file into the container at the following path and ensure the server starts with access to it.

{
  "mcpServers": {
    "kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "KIBELA_ORIGIN",
        "-e",
        "KIBELA_ACCESS_TOKEN",
        "-v",
        "/path/to/kibela-mcp-server-config.json:/usr/src/app/kibela-mcp-server-config.json",
        "ghcr.io/kibela/kibela-mcp-server"
      ],
      "env": {
        "KIBELA_ORIGIN": "https://your-subdomain.kibe.la",
        "KIBELA_ACCESS_TOKEN": "***"
      }
    }
  }
}

Notes and troubleshooting

Ensure Docker is running before starting the server. If you encounter authentication issues, double-check that your Kibela origin URL and access token are correct and that the token has the necessary scopes.

search_kibela_note

Search notes with multiple filters such as keywords, resource types, co-editing, update dates, group and folder filters, liker IDs, and sort order.

get_kibela_note_by_relay_id

Retrieve a note by its Relay ID.

get_kibela_note_from_path_or_url

Fetch a note using its path or URL.

get_kibela_notes

Get notes within a specified folder with optional pagination.

create_kibela_note

Create a new note with a title, content, and metadata like groups and folders.

update_kibela_note_content

Update the content of an existing note.

search_kibela_folder

Search folders by keyword.

get_kibela_folder_by_relay_id

Retrieve a folder by its Relay ID.

get_kibela_folder_from_path_or_url

Fetch a folder by path or URL.

get_kibela_folders

List folders with optional pagination.

create_kibela_folder

Create a new folder within a group.

move_kibela_note_to_another_folder

Move a note from one folder to another.

attach_kibela_note_to_folder

Attach a note to a folder.

create_kibela_comment

Create a comment on a note.

create_kibela_comment_reply

Create a reply to a comment.

get_kibela_groups

Fetch Kibela groups.

get_kibela_feed_sections

Get feed sections for a specific kind and group.