Kibela MCP Server

MCP server implementation for Kibela API integration, enabling LLMs to interact with Kibela content.

[!TIP] This extension performs GraphQL schema introspection using the buildClientSchema, getIntrospectionQuery, and printSchema functions from the graphql package to reverse engineer Kibela’s API. For more details, see her

Features

• Search notes with advanced filters
• Get your latest notes
• Get note content and comments
• Manage groups and folders
• Like/unlike notes
• List users
• View note attachments
• View recently viewed notes
• Get notes by path

Configuration

Environment Variables

• KIBELA_TEAM: Your Kibela team name (required)
• KIBELA_TOKEN: Your Kibela API token (required)

Cursor Integration

Add to your ~/.cursor/mcp.json:

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

If you want to use docker instead

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

Tools

kibela_search_notes

Search Kibela notes with given query

• Input:
  • query (string): Search query
  • coediting (boolean, optional): Filter by co-editing status
  • isArchived (boolean, optional): Filter by archive status
  • sortBy (string, optional): Sort by (RELEVANT, CONTENT_UPDATED_AT)
  • userIds (string[], optional): Filter by user IDs
  • folderIds (string[], optional): Filter by folder IDs