mcp-kibela

mcp-kibela

MCP server for secure, AI-assisted access to Kibela notes.

12
Stars
7
Forks
12
Watchers
2
Issues
mcp-kibela is a Model Context Protocol (MCP) server implementation that enables AI assistants to search, retrieve, create, and update content from Kibela, a team knowledge-sharing platform. It provides standardized endpoints for note search, fetching individual or recent notes, and managing note content. Integrating with tools like Claude, Cursor, and VSCode, it allows seamless, secure access to organizational knowledge through MCP-enabled clients. Authentication via environment variables ensures secure connections to Kibela APIs.

Key Features

Keyword-based search of Kibela notes
Retrieval of user's latest notes
Access to note content and comments by ID
Fetch notes by specific path
Create new notes in Kibela
Update existing note content by note ID
Environment variable-based configuration for security
Dockerized deployment for easy client integration
Compatibility with Claude, Cursor, VSCode, and Smithery
Inspection and development tools for MCP protocol compliance

Use Cases

Allowing AI assistants to answer queries using up-to-date organizational knowledge
Automating knowledge base searches within Kibela from AI clients
Enabling seamless note creation or updates via AI-powered tools
Integrating Kibela content into developer workflows through MCP clients
Securely providing context to models for customer or team support scenarios
Personal retrieval of latest authored notes for task tracking or summarization
Fetching specific note content or comments to inform model responses
Building custom workflows for documentation management using MCP protocol
Providing standardized server-side API for AI model context enrichment
Facilitating audit and inspection of AI access to organizational notes

README

mcp-kibela 🗒️

smithery badge npm version License: MIT

A Model Context Protocol (MCP) server implementation that enables AI assistants to search and reference Kibela content. This setup allows AI models like Claude to securely access information stored in Kibela.

Features 🚀

The mcp-kibela server provides the following features:

  • Note Search: Search Kibela notes by keywords
  • My Notes: Fetch your latest notes
  • Note Content: Get note content and comments by ID
  • Note by Path: Get note content by path
  • Create Note: Create a new note
  • Update Note Content: Update note content by note id

Prerequisites 📋

Before you begin, ensure you have:

  • Node.js (v18 or higher)
  • MCP Client (Claude Desktop, Cursor, etc.)
  • Kibela Access Token (How to get a token)
  • Git (if building from source)

Installation 🛠️

Usage with Cursor

json
{
  "kibela": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "KIBELA_TEAM",
      "-e",
      "KIBELA_TOKEN",
      "ghcr.io/kj455/mcp-kibela:latest"
    ],
    "env": {
      "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
      "KIBELA_TOKEN": "your-token"
    }
  }
}

Usage with VSCode

json
{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "kibela_team",
        "description": "Kibela team name",
        "password": false
      },
      {
        "type": "promptString",
        "id": "kibela_token",
        "description": "Kibela token",
        "password": true
      },
    ],
    "servers": {
      "kibela": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "KIBELA_TEAM",
          "-e",
          "KIBELA_TOKEN",
          "ghcr.io/kj455/mcp-kibela:latest"
        ],
        "env": {
          "KIBELA_TEAM": "${input:kibela_team}",
          "KIBELA_TOKEN": "${input:kibela_token}"
        }
      }
    }
  }
}

Usage with Claude Desktop

json
{
  "mcpServers": {
    "mcp-kibela": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KIBELA_TEAM",
        "-e",
        "KIBELA_TOKEN",
        "ghcr.io/kj455/mcp-kibela:latest"
      ],
      "env": {
        "KIBELA_TEAM": "your-team-name from https://[team-name].kibe.la",
        "KIBELA_TOKEN": "your-token"
      }
    }
  }
}

Using Smithery

bash
npx -y @smithery/cli install @kj455/mcp-kibela --client claude

Environment Variables

The following environment variables are required:

  • KIBELA_TEAM: Your Kibela team name (required). You can find it from the URL of your Kibela team page. e.g. https://[team-name].kibe.la
  • KIBELA_TOKEN: Your Kibela API token (required)

Contributing

Any contributions are welcome!

Development

  1. Use npm run build:watch to build the project in watch mode.
bash
npm run build:watch
  1. Use npx @modelcontextprotocol/inspector to inspect the MCP server.
bash
npx @modelcontextprotocol/inspector node /path/to/mcp-kibela/dist/index.js

License 📄

MIT

Star History

Star History Chart

Repository Owner

kj455
kj455

User

Repository Details

Language TypeScript
Default Branch main
Size 124 KB
Contributors 2
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

TypeScript
90.87%
JavaScript
5.95%
Dockerfile
3.18%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Apple Notes MCP Server

    Apple Notes MCP Server

    Enables Claude Desktop to access and interact with local Apple Notes.

    Apple Notes MCP Server reads and provides access to local Apple Notes databases for use in Claude Desktop. It allows querying all notes, retrieving specific note content, and searching notes, facilitating deeper context integration for AI workflows. The server operates under the Model Context Protocol (MCP) and is designed for straightforward installation and integration. Currently, it supports reading and searching but does not handle encrypted notes, attachments, or note creation/editing.

    • 121
    • MCP
    • sirmews/apple-notes-mcp
  • kibitz

    kibitz

    The coding agent for professionals with MCP integration.

    kibitz is a coding agent that supports advanced AI collaboration by enabling seamless integration with Model Context Protocol (MCP) servers via WebSockets. It allows users to configure Anthropic API keys, system prompts, and custom context providers for each project, enhancing contextual understanding for coding tasks. The platform is designed for developers and professionals seeking tailored AI-driven coding workflows and provides flexible project-specific configuration.

    • 104
    • MCP
    • nick1udwig/kibitz
  • HackMD MCP Server

    HackMD MCP Server

    MCP server connecting LLM clients to the HackMD collaborative note platform.

    HackMD MCP Server implements the Model Context Protocol (MCP) to provide a standardized interface between large language model (LLM) clients and the HackMD collaborative note service. Through HTTP and STDIO transports, it enables creation, retrieval, update, and deletion of notes, along with management of teams, user profiles, and history data. It supports deployment in both local and cloud environments, with secure API token-based authentication and configuration via environment variables or HTTP headers.

    • 43
    • MCP
    • yuna0x0/hackmd-mcp
  • MCP Obsidian Server

    MCP Obsidian Server

    Integrate Obsidian note management with AI models via the Model Context Protocol.

    MCP Obsidian Server acts as a bridge between Obsidian and AI models by providing an MCP-compatible server interface. It enables programmatic access to Obsidian vaults through a local REST API, allowing operations like listing files, searching, reading, editing, and deleting notes. Designed to work with Claude Desktop and other MCP-enabled clients, it exposes a set of tools for efficient note and content management within Obsidian.

    • 2,394
    • MCP
    • MarkusPfundstein/mcp-obsidian
  • MCP Manager for Claude Desktop

    MCP Manager for Claude Desktop

    A desktop app to manage Model Context Protocol (MCP) servers for Claude Desktop on MacOS.

    MCP Manager for Claude Desktop provides a user-friendly interface to manage Model Context Protocol (MCP) servers, enabling Claude to access private data, APIs, and local or remote services securely from a MacOS desktop. It facilitates rapid configuration and integration with a wide variety of MCP servers, including productivity tools, databases, and web APIs. The app runs locally to ensure data privacy and streamlines connecting Claude to new sources through simple environment and server settings management.

    • 270
    • MCP
    • zueai/mcp-manager
  • Coda MCP Server

    Coda MCP Server

    A Model Context Protocol server enabling seamless interaction with Coda documents and pages.

    Coda MCP Server implements a Model Context Protocol (MCP) server that bridges AI assistants or MCP clients with the Coda API. It provides standardized tools for listing, creating, reading, updating, duplicating, and renaming Coda pages, as well as handling document context. The server communicates over standard input/output, supporting integration with platforms like Cursor and Claude Desktop, and can be deployed via Node.js or Docker.

    • 36
    • MCP
    • orellazri/coda-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results