Reference

MCP integration

Install GNO as an MCP server for Claude Desktop, Cursor, Zed, Windsurf, Amp, Raycast, and more.

Model Context Protocol (MCP) is how AI assistants access external tools. GNO ships a production-grade MCP server with 19 tools for search, retrieval, graph exploration, and indexing. One-line install for every major client.

Supported clients

Claude Desktop
Cursor
Zed
Windsurf
Amp
Raycast
LM Studio
LibreChat
Any MCP-compatible client via a stdio transport

One-line install

gno mcp install # auto-detects clients
gno mcp install --target cursor
gno mcp install --target zed
gno mcp install --target claude-desktop
gno mcp install --target windsurf
gno mcp install --target amp

Each target adds GNO to the correct config file for that client. Restart the client to pick up the new server.

Available tools

19 tools across retrieval, navigation, and indexing:

search, vsearch, query, ask — the retrieval pipeline
get, multi_get — fetch documents by id
links, backlinks, similar — navigate connections
graph — explore the knowledge graph
collections_list — discover available collections
tags_list, tags_filter — work with tag taxonomy
capture — create a new note (disabled by default)
sync, embed, index — indexing operations (disabled by default)

Security posture

Write tools (capture, sync, embed, index) are disabled by default so your AI client can’t accidentally modify the corpus. Enable them explicitly per client:

gno mcp install --target cursor --allow-write

Resource URIs

GNO exposes every document as an MCP resource, so clients can fetch a file by URI without going through a tool call.

gno://documents/<id>
gno://collections/<name>