Kibela MCP Server
The Kibela MCP Server enables interaction with Kibela content via LLMs, providing these capabilities:
Search notes: Use advanced filters like co-editing status, archive status, sort order, user IDs, and folder IDs
Get your latest notes: Retrieve your most recent notes with customizable limits
Get note content and comments: Fetch full content and comments for specific notes
Manage groups and folders: List accessible groups, their folders, and contained notes
Like/unlike notes: Toggle likes on notes and view updated likers lists
List users: Retrieve user details
View note attachments: Access linked attachments
View recently viewed notes: Get your browsing history
Get notes by path: Retrieve notes using paths or full URLs
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kibela MCP Server search notes about project planning from last month"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Kibela MCP Server
MCP server implementation for Kibela API integration, enabling LLMs to interact with Kibela content.
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 querycoediting(boolean, optional): Filter by co-editing statusisArchived(boolean, optional): Filter by archive statussortBy(string, optional): Sort by (RELEVANT, CONTENT_UPDATED_AT)userIds(string[], optional): Filter by user IDsfolderIds(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 IDinclude_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 IDparentFolderId(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 IDlimit(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
Clone the repository
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.jsand 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 toolskibela_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
Scored across 12 tools
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.
All tools follow a consistent pattern: 'kibela_verb_noun' with present tense verbs. The naming is uniform and predictable, with no mixing of conventions.
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.
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
Create, search and manage Knowtis collaborative notes from AI assistants.
Search and read your meeting notes, transcripts and action items, and create notes in Reline.
Search and read your own notes: insights, drafts, book and podcast notes. Read-only, OAuth.
Search, read, create and edit your Memol notes from Claude. Team note-taking with AI search.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Notion through the Notion API by exposing it as tools for LLMs, allowing operations like reading, creating, updating, and deleting Notion pages seamlessly via natural language.13 npm21MIT
- AlicenseCqualityBmaintenanceEnables interaction with note.com through API to search and read articles, manage posts and drafts, handle comments and likes, retrieve analytics, and access membership information.3436 npm31ISC
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Notion workspaces through the Notion API, allowing them to search, read, create, update pages and databases, and manage comments using natural language commands.MIT
- AlicenseAqualityDmaintenanceEnables Claude Desktop to interact with KURA Notes API for semantic search, note creation, retrieval, and management. Supports natural language queries to search, create, retrieve, list, and delete notes with metadata like titles, tags, and annotations.5Elastic 2.0