Skip to main content
Glama
Kibela MCP Server

Kibela MCP Server

Kibela MCP Server

NPM Downloads License: MIT Trust Score LightNow capabilities

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

Related MCP server: note.com MCP Server

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

  • Returns: List of matching notes with ID, title, URL, author, groups and more

kibela_get_my_notes

Get your latest notes from Kibela

  • Input:

    • limit (number, optional): Number of notes to fetch (default: 15)

  • Returns: List of your latest notes with author information

kibela_get_note_content

Get content and comments of a specific note

  • Input:

    • id (string): Note ID

    • include_image_data (boolean, optional): Whether to include image data URLs in the response (default: false)

  • Returns: Full note content including HTML, comments, attachments, groups, folders and more

kibela_get_groups

Get list of accessible groups

  • Input: None

  • Returns: List of groups with details like privacy settings and permissions

kibela_get_group_folders

Get folders in a group

  • Input:

    • groupId (string): Group ID

    • parentFolderId (string, optional): Parent folder ID for nested folders

  • Returns: List of folders with their notes and metadata

kibela_get_group_notes

Get notes in a group that are not attached to any folder

  • Input:

    • groupId (string): Group ID

  • Returns: List of notes with author information, sorted by last update time

kibela_get_folder_notes

Get notes in a folder

  • Input:

    • folderId (string): Folder ID

    • limit (number, optional): Number of notes to fetch (default: 100)

  • Returns: List of notes with author information, sorted by last update time

kibela_get_users

Get list of users

  • Input: None

  • Returns: List of users with ID, account and real name

kibela_like_note

Like a note

  • Input:

    • noteId (string): Note ID

  • Returns: Updated likers list

kibela_unlike_note

Unlike a note

  • Input:

    • noteId (string): Note ID

  • Returns: Updated likers list

kibela_get_recently_viewed_notes

Get your recently viewed notes

  • Input:

    • limit (number, optional): Number of notes to fetch (max 15)

  • Returns: List of recently viewed notes with author information

kibela_get_note_from_path

Get note content by its path or URL

  • Input:

    • path (string): Note path (e.g. '/group/folder/note') or full Kibela URL (e.g. 'https://team.kibe.la/notes/123')

    • include_image_data (boolean, optional): Whether to include image data URLs in the response (default: false)

  • Returns: Full note content including HTML, comments, attachments, groups, folders and more

Local Development

Running from Source

  1. Clone the repository

  2. Install dependencies: npm install

Environment Setup

For local development, update your ~/.cursor/mcp.json:

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

MCP inspector

npx @modelcontextprotocol/inspector node ./dist/src/index.js

and set environemtns

Docker

Build and run locally:

docker build -t mcp-kibela-server .

Then use this configuration:

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

For SSE transport, ensure the server URL is set to: http://localhost:3000/sse

Other products

Available Tools

12 tools
kibela_get_folder_notesC

Get notes in a folder

Inputs: folderId (required), limit.

kibela_get_group_foldersC

Get folders in a group

Inputs: groupId (required), parentFolderId.

kibela_get_group_notesB

Get notes in a group that are not attached to any folder

Inputs: groupId (required).

kibela_get_groupsB

Get list of accessible groups

Inputs: no named parameters.

kibela_get_my_notesA

Get your latest notes from Kibela

Inputs: limit.

kibela_get_note_contentC

Get content and comments of a specific note

Inputs: id (required), include_image_data.

kibela_get_note_from_pathC

Get note content by its URL

Inputs: path (required), include_image_data.

kibela_get_recently_viewed_notesB

Get your recently viewed notes

Inputs: limit.

kibela_get_usersC

Get list of users

Inputs: no named parameters.

kibela_like_noteC

Like a note

Inputs: noteId (required).

kibela_search_notesB

Search Kibela notes with given query

Inputs: query (required), coediting, isArchived, sortBy, +2 more.

kibela_unlike_noteC

Unlike a note

Inputs: noteId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but some overlap exists between tools that retrieve notes in different contexts (e.g., get_note_content vs get_note_from_path) and between personal note lists (get_my_notes vs get_recently_viewed_notes). Descriptions help disambiguate, so the set is mostly clear.

    Naming Consistency5/5

    All tools follow a consistent pattern: 'kibela_verb_noun' with present tense verbs. The naming is uniform and predictable, with no mixing of conventions.

    Tool Count5/5

    With 12 tools, the count is well-suited for a knowledge management server. It provides a balanced set of read operations, search, and simple interactions without being overwhelming or too sparse.

    Completeness2/5

    The tool set is heavily read-only, covering notes, folders, groups, and users, plus like/unlike. However, it lacks essential write operations such as creating, updating, or deleting notes or groups, which limits its completeness for typical workflows.

    Related MCP Connectors

    Related MCP Servers