Kybase MCP Server

io.github.Kyrzin/kybase

Repository Registry

What is the Kybase MCP server?

Self-hosted Markdown memory for AI agents: notes you can read and edit, with hybrid search.

How to install Kybase

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

KYBASE_DATA_DIR
Where the embedded database and instance secret live. Defaults to ~/.kybase
EMBEDDING_PROVIDER
Embedding provider for semantic search
OLLAMA_URL
Ollama endpoint for local embeddings. Without any provider, full-text search still works
OLLAMA_MODEL
Ollama embedding model
GOOGLE_API_KEY
secret
Google API key, when EMBEDDING_PROVIDER=google. Sends note text to Google
OPENAI_API_KEY
secret
OpenAI API key, when EMBEDDING_PROVIDER=openai. Sends note text to OpenAI
DATABASE_URL
secret
Use an existing Kybase Postgres instead of the embedded one (migrations are left to the app)

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "kybase": {
      "command": "npx",
      "args": [
        "-y",
        "kybase-mcp"
      ],
      "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>"
      }
    }
  }
}