Kibela

You can run the Kibela MCP Server to enable large language models to interact with Kibela content through a programmable interface. This server provides endpoints for searching notes, retrieving note content, managing groups and folders, liking notes, and more, all via MCP-compatible commands.

How to use

After you start the Kibela MCP Server, connect your MCP client to the local server instance. You will typically use a local stdio configuration (running the server as a child process) or a containerized setup. Use the provided tools to search notes, fetch your latest notes, read note content with comments, manage groups and folders, handle attachments, and view recently viewed notes. You can also fetch notes by path or URL.

How to install

Prerequisites: you need Node.js installed if you run from source, or Docker if you prefer containerized execution.

Step 1: Choose an installation method and follow the corresponding commands.

{
  "mcpServers": {
    "kibela": {
      "command": "npx",
      "args": ["-y", "@kiwamizamurai/mcp-kibela-server"],
      "env": {
        "KIBELA_TEAM": "YOUR_TEAM_NAME",
        "KIBELA_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

How to install from Docker

If you prefer using Docker, use the following configuration to run the MCP server in a container.

{
  "mcpServers": {
    "kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kiwamizamurai/mcp-kibela-server:latest"
      ],
      "env": {
        "KIBELA_TEAM": "YOUR_TEAM_NAME",
        "KIBELA_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Run from source locally

To run directly from the source, ensure you have dependencies installed and start the server with Node from the built distribution.

{
  "mcpServers": {
    "kibela": {
      "command": "node",
      "args": ["path/to/mcp-kibela-server/dist/src/index.js"],
      "env": {
        "KIBELA_TEAM": "YOUR_TEAM_NAME",
        "KIBELA_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Available tools

kibela_search_notes

Search Kibela notes with a query and optional filters such as coediting, archived status, sort order, and author/folder constraints.

kibela_get_my_notes

Fetch your latest Kibela notes with an optional limit and author information.

kibela_get_note_content

Retrieve the full content of a specific note, including HTML, comments, attachments, and related metadata.

kibela_get_groups

List groups accessible to the authenticated user along with privacy and permissions.

kibela_get_group_folders

List folders within a group and provide nested folder structures and note associations.

kibela_get_group_notes

Get notes within a group that are not attached to folders, sorted by last update.

kibela_get_folder_notes

List notes contained in a folder with optional limiting and author information.

kibela_get_users

Retrieve a list of users with IDs and account names.

kibela_like_note

Like a specific note and return the updated list of likers.

kibela_unlike_note

Unlike a specific note and return the updated list of likers.

kibela_get_recently_viewed_notes

Get the user's recently viewed notes with author information.

kibela_get_note_from_path

Fetch note content by path or Kibela URL, including full metadata.