# gknowledge

> gknowledge is a free MCP server for knowledge and memory. Search, read and grow a linked Markdown wiki with cited answers, via the gknowledge app. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Linux, CLI
- **Website:** https://openapi.github.io/gknowledge
- **Repository:** https://github.com/openapi/gknowledge
- **MCP Registry name:** io.github.openapi/gknowledge
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-15

## About

gknowledge is a native GNOME application, built with GTK 4 and Libadwaita rather than a web view, that follows the LLM Wiki pattern popularised by Karpathy: ingest documents, let a model build and maintain linked pages, then ask questions against them. This MCP server lets an assistant search, read and extend that same wiki, which is stored as plain Markdown with YAML frontmatter and a readable SQLite index, so it also opens in Obsidian or any editor.

The README says it works offline with a built-in heuristic engine and no account, and you can add a local model, any OpenAI-compatible endpoint or your own ChatGPT plan for better synthesis. Every generated page records its sources, answers cite pages, and a review queue lets you approve AI changes. Questions use lexical search with graph expansion.

The MCP package is gknowledge-mcp on PyPI over stdio. The app itself installs from a signed APT repository on Ubuntu 24.04+ and Debian 13+, or from Flatpak on other distributions.

## Features

- **Native GNOME app:** Built on GTK 4 and Libadwaita with no Electron or browser engine.
- **Plain Markdown vault:** Pages are Markdown with YAML frontmatter plus a SQLite index, Obsidian-compatible.
- **Cited answers:** Generated pages record sources and answers cite the pages they use.
- **Offline by default:** A built-in heuristic engine ingests and answers without an account or API key.
- **Bring your own model:** Use a local model, an OpenAI-compatible endpoint or your own ChatGPT plan.
- **Review queue:** AI-made changes can be checked before they stick.

## Good for

- Turn a folder of research papers into a linked wiki
- Let a coding assistant search and read your notes
- Grow a personal knowledge base from new documents
- Answer questions with page citations
- Keep a vault editable in Obsidian

## Install

### Claude Code (Terminal)

```sh
claude mcp add gknowledge -- uvx gknowledge-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gknowledge": {
      "command": "uvx",
      "args": [
        "gknowledge-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gknowledge": {
      "command": "uvx",
      "args": [
        "gknowledge-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gknowledge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gknowledge-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gknowledge": {
      "command": "uvx",
      "args": [
        "gknowledge-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gknowledge": {
      "command": "uvx",
      "args": [
        "gknowledge-mcp"
      ]
    }
  }
}
```

## FAQ

### Do I need an API key?

No. A built-in heuristic engine works offline; a model is optional.

### Where is my data stored?

As Markdown files with YAML frontmatter and a SQLite index in a folder you can open elsewhere.

### Which systems are supported?

APT packages for Ubuntu 24.04+ and Debian 13+, Flatpak for other distributions, or install from source.

### What is the MCP package called?

gknowledge-mcp on PyPI, running over stdio.

### Is gknowledge free?

Yes. gknowledge is free to use.

### How do I add gknowledge to Claude Code?

Run this command in your terminal: claude mcp add gknowledge -- uvx gknowledge-mcp

### What are the best alternatives to gknowledge?

The closest alternatives to gknowledge are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/gknowledge
