Overview

Kibela MCP Server is currently available only as a local server using STDIO and can be used with any MCP client such as Claude Desktop or VSCode.

Only those GraphQL APIs that are publicly available and suitable for MCP are implemented as tools.

Use Cases

• Ask about information in Kibela
• Organize folders and articles in Kibela
• Using AI to help you write with Kibela

Requirements

1. Docker is installed
2. Docker must be running
3. Kibela access tokens is issued
4. An application that implements the MCP client must be installed

Installation

Example: Claude Desktop

Write the following configuration to claude_desktop_config.json. Set the Kibela origin and access token as environment variables.

{
  "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": "***"
      }
    }
  }
}

No Docker

Then set the script as the execution command. At this time, make sure that the path to the script is absolute.

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

Available Tools

Note Operations

• search_kibela_note - Search notes

  • query: Search keyword (required)
  • resources: Resource type filter (optional)
  • coediting: Co-editing flag (optional)
  • updated: Update date range (optional)
  • groupIds: Group ID filter (optional)
  • folderIds: Folder ID filter (optional)
  • likerIds: Liker user ID filter (optional)
  • isArchived: Archive flag (optional)
  • sortBy: Sort order (optional)

• get_kibela_note_by_relay_id - Get a note by Relay ID

  • id: Note's Relay ID (required)

• get_kibela_note_from_path_or_url - Get a note from path or URL

  • path: Note's path or URL (required)

• get_kibela_notes - Get notes in a folder

  • folderId: Folder ID (required)
  • first: Number of records from front (optional)
  • last: Number of records from back (optional)

• create_kibela_note - Create a new note

  • title: Note title (required)
  • content: Note content (required)
  • draft: Draft flag (optional)
  • groupIds: List of group IDs to belong to (required)
  • folders: Folder information (optional)
    • groupId: Group ID
    • folderName: Folder name

• update_kibela_note_content - Update note content

  • id: Note ID (required)
  • newContent: New content (required)
  • baseContent: Original content (required)

Folder Operations

• search_kibela_folder - Search folders

  • query: Search keyword (required)

• get_kibela_folder_by_relay_id - Get a folder by Relay ID

  • id: Folder's Relay ID (required)
  • first: Number of records from front (optional)

• get_kibela_folder_from_path_or_url - Get a folder from path or URL

  • path: Folder's path or URL (required)
  • first: Number of records from front (optional)

• `get_kibela_fold

... View full README on GitHub