MCP server for org-roam knowledge management. Provides AI agent tools for semantic search, note creation, and daily entries. Install with: pip install org-roam-mcp or curl -fsSL https://raw.githubusercontent.com/dcruver/org-roam-ai/main/install.sh | bash
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"org-roam-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Org-roam MCP Server **[org-roam-ai](../README.md) > MCP Server** An MCP (Model Context Protocol) server that provides clean, typed tool interfaces for AI agents to interact with an org-roam knowledge management system running in Emacs. ## Overview This server wraps existing org-roam elisp functions via `emacsclient`, providing structured MCP tools that can be used by AI agents (particularly designed for n8n AI Agent nodes) instead of complex shell command workflows. ## Features ### Core MCP Tools - **contextual_search** - Enhanced search with full content, backlinks, and relevance scores for RAG applications - **create_note** - Create new org-roam notes with proper structure and metadata - **add_daily_entry** - Add structured entries to daily notes (journal or TODO types) - **get_daily_content** - Retrieve daily note content - **search_notes** - Basic search across note titles and content - **sync_database** - Sync org-roam database ## Requirements - Python 3.8+ - Emacs with org-roam running - Emacs server accessible via `emacsclient` - The `org-roam-api.el` functions available in your Emacs instance ## Installation ### For Users **One-shot installation (Recommended):** ```bash # Download and run the installation script curl -fsSL https://raw.githubusercontent.com/dcruver/org-roam-ai/main/install.sh | bash ``` **Install from PyPI:** ```bash pip install org-roam-mcp ``` **Install from GitHub (Development):** ```bash pip install git+https://github.com/dcruver/org-roam-ai.git#subdirectory=mcp ``` ### For Developers ```bash # Clone repository git clone gitea@gitea-backend.cruver.network:dcruver/org-roam-mcp.git cd org-roam-mcp # Create and activate virtual environment python -m venv .venv source .venv/bin/activate # On Linux/Mac # OR: .venv\Scripts\activate # On Windows # Install in development mode pip install -e . # Or install with dev dependencies for testing pip install -e ".[dev]" ``` For complete distribution guide (publishing to packag…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.