remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Kibela MCP Server
MCP server implementation for Kibela API integration, enabling LLMs to interact with Kibela content.
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
:
If you want to use docker instead
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 ID
- 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
:
MCP inspector
and set environemtns
Docker
Build and run locally:
Then use this configuration:
For SSE transport, ensure the server URL is set to: http://localhost:3000/sse
Other products
You must be authenticated.
Enables integration with Kibela API for searching and retrieving notes, allowing LLMs to interact with Kibela content seamlessly.