Kibela MCP Server

1# Kibela MCP Server
2![NPM Downloads](https://img.shields.io/npm/dm/%40kiwamizamurai%2Fmcp-kibela-server)
3[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
4[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/kiwamizamurai/mcp-kibela-server)](https://archestra.ai/mcp-catalog/kiwamizamurai__mcp-kibela-server)
5[![smithery badge](https://smithery.ai/badge/@kiwamizamurai/mcp-kibela-server)](https://smithery.ai/server/@kiwamizamurai/mcp-kibela-server)
6 
7MCP server implementation for Kibela API integration, enabling LLMs to interact with Kibela content.
8 
9<img width="320" alt="Example" src="https://github.com/user-attachments/assets/eeed8f45-eb24-456d-bb70-9e738aa1bfb3" /><a href="https://glama.ai/mcp/servers/m21nkeig1p"><img width="380" height="200" src="https://glama.ai/mcp/servers/m21nkeig1p/badge" alt="Kibela Server MCP server" /></a>
10 
11> [!TIP]
12> 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](https://github.com/kiwamizamurai/vscode-kibela/blob/main/reverse_engineering/main.ts)
13 
14## Features
15 
16- Search notes with advanced filters
17- Get your latest notes
18- Get note content and comments
19- Manage groups and folders
20- Like/unlike notes
21- List users
22- View note attachments
23- View recently viewed notes
24- Get notes by path
25 
26## Configuration
27 
28### Environment Variables
29 
30- `KIBELA_TEAM`: Your Kibela team name (required)
31- `KIBELA_TOKEN`: Your Kibela API token (required)
32 
33## Cursor Integration
34 
35Add to your `~/.cursor/mcp.json`:
36 
37```json
38{
39    "mcpServers": {
40        "kibela": {
41            "command": "npx",
42            "args": ["-y", "@kiwamizamurai/mcp-kibela-server"],
43            "env": {
44                "KIBELA_TEAM": "YOUR_TEAM_NAME",
45                "KIBELA_TOKEN": "YOUR_TOKEN"
46            }
47        }
48    }
49}
50```
51 
52If you want to use docker instead
53 
54```json
55{
56    "mcpServers": {
57        "kibela": {
58            "command": "docker",
59            "args": [
60                "run",
61                "-i",
62                "--rm",
63                "-e",
64                "KIBELA_TEAM",
65                "-e",
66                "KIBELA_TOKEN",
67                "ghcr.io/kiwamizamurai/mcp-kibela-server:latest"
68            ],
69            "env": {
70                "KIBELA_TEAM": "YOUR_TEAM_NAME",
71                "KIBELA_TOKEN": "YOUR_TOKEN"
72            }
73        }
74    }
75}
76```
77 
78## Tools
79 
80### kibela_search_notes
81Search Kibela notes with given query
82- Input:
83  - `query` (string): Search query
84  - `coediting` (boolean, optional): Filter by co-editing status
85  - `isArchived` (boolean, optional): Filter by archive status
86  - `sortBy` (string, optional): Sort by (RELEVANT, CONTENT_UPDATED_AT)
87  - `userIds` (string[], optional): Filter by user IDs
88  - `folderIds` (string[], optional): Filter by folder IDs
89- Returns: List of matching notes with ID, title, URL, author, groups and more
90 
91### kibela_get_my_notes
92Get your latest notes from Kibela
93- Input:
94  - `limit` (number, optional): Number of notes to fetch (default: 15)
95- Returns: List of your latest notes with author information
96 
97### kibela_get_note_content
98Get content and comments of a specific note
99- Input:
100  - `id` (string): Note ID
101  - `include_image_data` (boolean, optional): Whether to include image data URLs in the response (default: false)
102- Returns: Full note content including HTML, comments, attachments, groups, folders and more
103 
104### kibela_get_groups
105Get list of accessible groups
106- Input: None
107- Returns: List of groups with details like privacy settings and permissions
108 
109### kibela_get_group_folders
110Get folders in a group
111- Input:
112  - `groupId` (string): Group ID
113  - `parentFolderId` (string, optional): Parent folder ID for nested folders
114- Returns: List of folders with their notes and metadata
115 
116### kibela_get_group_notes
117Get notes in a group that are not attached to any folder
118- Input:
119  - `groupId` (string): Group ID
120- Returns: List of notes with author information, sorted by last update time
121 
122### kibela_get_folder_notes
123Get notes in a folder
124- Input:
125  - `folderId` (string): Folder ID
126  - `limit` (number, optional): Number of notes to fetch (default: 100)
127- Returns: List of notes with author information, sorted by last update time
128 
129### kibela_get_users
130Get list of users
131- Input: None
132- Returns: List of users with ID, account and real name
133 
134### kibela_like_note
135Like a note
136- Input:
137  - `noteId` (string): Note ID
138- Returns: Updated likers list
139 
140### kibela_unlike_note
141Unlike a note
142- Input:
143  - `noteId` (string): Note ID
144- Returns: Updated likers list
145 
146### kibela_get_recently_viewed_notes
147Get your recently viewed notes
148- Input:
149  - `limit` (number, optional): Number of notes to fetch (max 15)
150- Returns: List of recently viewed notes with author information
151 
152### kibela_get_note_from_path
153Get note content by its path or URL
154- Input:
155  - `path` (string): Note path (e.g. '/group/folder/note') or full Kibela URL (e.g. 'https://team.kibe.la/notes/123')
156  - `include_image_data` (boolean, optional): Whether to include image data URLs in the response (default: false)
157- Returns: Full note content including HTML, comments, attachments, groups, folders and more
158 
159## Local Development
160 
161### Running from Source
162 
1631. Clone the repository
1642. Install dependencies: `npm install`
165 
166### Environment Setup
167 
168For local development, update your `~/.cursor/mcp.json`:
169 
170```json
171{
172    "mcpServers": {
173        "kibela": {
174            "command": "node",
175            "args": ["path/to/mcp-kibela-server/dist/src/index.js"],
176            "env": {
177                "KIBELA_TEAM": "YOUR_TEAM_NAME",
178                "KIBELA_TOKEN": "YOUR_TOKEN"
179            }
180        }
181    }
182}
183```
184 
185### MCP inspector
186 
187```bash
188npx @modelcontextprotocol/inspector node ./dist/src/index.js
189```
190 
191and set environemtns
192 
193 
194### Docker
195 
196Build and run locally:
197 
198```bash
199docker build -t mcp-kibela-server .
200```
201 
202Then use this configuration:
203 
204```json
205{
206    "mcpServers": {
207        "kibela": {
208            "command": "docker",
209            "args": [
210                "run",
211                "-i",
212                "--rm",
213                "-e",
214                "KIBELA_TEAM",
215                "-e",
216                "KIBELA_TOKEN",
217                "mcp-kibela-server"
218            ],
219            "env": {
220                "KIBELA_TEAM": "YOUR_TEAM_NAME",
221                "KIBELA_TOKEN": "YOUR_TOKEN"
222            }
223        }
224    }
225}
226```
227For SSE transport, ensure the server URL is set to: `http://localhost:3000/sse`
228 
229 
230# Other products
231 
232- [vscode extension for kibela](https://marketplace.visualstudio.com/items?itemName=kiwamizamurai-vscode.kibela-vscode)
233