Kibela

Kibela

Interact with Kibela API.

7
Stars
6
Forks
2
Releases

Overview

Kibela MCP Server is an MCP server implementation that enables LLMs to interact with Kibela content via the Kibela API. It uses GraphQL schema introspection (buildClientSchema, getIntrospectionQuery, printSchema) to reverse engineer Kibela's API, providing programmatic access to notes, groups, folders, users, and attachments. The server exposes a set of tools that map to common Kibela operations, including searching notes with advanced filters, fetching your latest notes, retrieving note content and comments, managing groups and folders, liking or unliking notes, listing users, and viewing attachments or notes by path. The project highlights environment variables KIBELA_TEAM and KIBELA_TOKEN as required credentials for API access. It supports running via npm (npx @kiwamizamurai/mcp-kibela-server) or Docker, with explicit Cursor integration examples. Local development guidance includes building from source, environment setup, and an MCP inspector tool for debugging. For SSE transport, the recommended server URL is http://localhost:3000/sse. The README also documents a variety of Kibela-specific operations (search, content retrieval, group/folder navigation, user listing, like/unlike, and path-based access) that are exposed through the MCP server.

Details

Owner
kiwamizamurai
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Search notes with advanced filters

Query Kibela notes with filters such as coediting status, isArchived, sortBy, userIds, and folderIds.

Get your latest notes

Fetch your most recent Kibela notes (default limit 15).

Get note content and comments

Retrieve full note content including HTML, comments, attachments, and metadata.

Manage groups and folders

List groups and their folders, including nested structures and group metadata.

Like/unlike notes

Like or unlike a note and receive the updated list of likers.

List users

Fetch list of Kibela users with IDs and real names.

View note attachments

View attachments associated with notes.

Get notes by path

Fetch note content by path or full Kibela URL.

Tags

KibelaMCPGraphQLAPINotesGroupsFoldersSearchAttachmentsUsersCursorDocker