Kybase MCP
A self-hosted MCP server that provides AI agents with persistent, searchable Markdown memory. It allows agents to read, write, and search notes using hybrid search, while users can manage the same knowledge base via a web interface. It supports multiple agents sharing one vault and ensures data privacy by running locally or on user-controlled infrastructure.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Search notes by words and meaning
- Write and edit Markdown notes
- Link notes with wikilinks
- Export vault as Markdown
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
kybase-mcp 0.2.4
{
"version": "0.2.4",
"transport": "stdio",
"identifier": "kybase-mcp",
"runtimeHint": "npx",
"registryType": "npm",
"environmentVariables": [
{
"name": "KYBASE_DATA_DIR",
"format": "string",
"description": "Where the embedded database and instance secret live. Defaults to ~/.kybase"
},
{
"name": "EMBEDDING_PROVIDER",
"format": "string",
"choices": [
"ollama",
"google",
"openai"
],
"default": "ollama",
"description": "Embedding provider for semantic search"
},
{
"name": "OLLAMA_URL",
"format": "string",
"description": "Ollama endpoint for local embeddings. Without any provider, full-text search still works",
"placeholder": "http://localhost:11434"
},
{
"name": "OLLAMA_MODEL",
"format": "string",
"default": "embeddinggemma",
"description": "Ollama embedding model"
},
{
"name": "GOOGLE_API_KEY",
"format": "string",
"description": "Google API key, when EMBEDDING_PROVIDER=google. Sends note text to Google"
},
{
"name": "OPENAI_API_KEY",
"format": "string",
"description": "OpenAI API key, when EMBEDDING_PROVIDER=openai. Sends note text to OpenAI"
},
{
"name": "DATABASE_URL",
"format": "string",
"description": "Use an existing Kybase Postgres instead of the embedded one (migrations are left to the app)"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"kybase-mcp": {
"command": "npx",
"args": [
"-y",
"kybase-mcp@0.2.4"
],
"env": {
"KYBASE_DATA_DIR": "<YOUR_KYBASE_DATA_DIR>",
"EMBEDDING_PROVIDER": "<YOUR_EMBEDDING_PROVIDER>",
"OLLAMA_URL": "<YOUR_OLLAMA_URL>",
"OLLAMA_MODEL": "<YOUR_OLLAMA_MODEL>",
"GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"DATABASE_URL": "<YOUR_DATABASE_URL>"
}
}
}
}Cline
{
"mcpServers": {
"kybase-mcp": {
"command": "npx",
"args": [
"-y",
"kybase-mcp@0.2.4"
],
"env": {
"KYBASE_DATA_DIR": "<YOUR_KYBASE_DATA_DIR>",
"EMBEDDING_PROVIDER": "<YOUR_EMBEDDING_PROVIDER>",
"OLLAMA_URL": "<YOUR_OLLAMA_URL>",
"OLLAMA_MODEL": "<YOUR_OLLAMA_MODEL>",
"GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"DATABASE_URL": "<YOUR_DATABASE_URL>"
}
}
}
}VS Code
{
"servers": {
"kybase-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"kybase-mcp@0.2.4"
],
"env": {
"KYBASE_DATA_DIR": "<YOUR_KYBASE_DATA_DIR>",
"EMBEDDING_PROVIDER": "<YOUR_EMBEDDING_PROVIDER>",
"OLLAMA_URL": "<YOUR_OLLAMA_URL>",
"OLLAMA_MODEL": "<YOUR_OLLAMA_MODEL>",
"GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"DATABASE_URL": "<YOUR_DATABASE_URL>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"kybase-mcp": {
"command": "npx",
"args": [
"-y",
"kybase-mcp@0.2.4"
],
"env": {
"KYBASE_DATA_DIR": "<YOUR_KYBASE_DATA_DIR>",
"EMBEDDING_PROVIDER": "<YOUR_EMBEDDING_PROVIDER>",
"OLLAMA_URL": "<YOUR_OLLAMA_URL>",
"OLLAMA_MODEL": "<YOUR_OLLAMA_MODEL>",
"GOOGLE_API_KEY": "<YOUR_GOOGLE_API_KEY>",
"OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
"DATABASE_URL": "<YOUR_DATABASE_URL>"
}
}
}
}Let your agent find its tools
Find servers like Kybase MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.