1. Conduid
  2. Developer Tools
  3. Org Roam AI
MCP server · Developer Tools

Org Roam AI

by · github.com/dcruver/org-roam-ai

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

Unclaimed Custom license last commit 7 months ago devtools
InstallView source
52Fair

Scored yesterday · breakdown

About Org Roam AI

Org Roam AI is an MCP server published by dcruver in the Developer Tools category: 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.

The repository has 1 stars and 1 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/dcruver/org-roam-ai

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (7)

add_daily_entryAdd entry to daily note

Parameters not published.

add_inbox_entryLog to inbox for audit trail

Parameters not published.

contextual_searchKeyword search with context

Parameters not published.

create_noteCreate new org-roam note

Parameters not published.

search_notesBasic title/content search

Parameters not published.

semantic_searchVector-based semantic search

Parameters not published.

sync_databaseSync org-roam database

Parameters not published.

Ask AI

✦

Ask AI about Org Roam AI

Powered by Claude · Grounded in docs

I know everything about Org Roam AI. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

3 checks have not been run yet.

Releases

v0.1.1v0.1.1
agent-v0.2.2agent-v0.2.2

README

⚠️ DEPRECATED: This repository has been merged into org-roam-second-brain.

All functionality from this repo (including org-roam-api.el and the MCP server) is now part of org-roam-second-brain. Please use that repository for the latest updates.

org-roam-ai

MCP Server and API for org-roam knowledge base integration

This repository provides the MCP (Model Context Protocol) server that enables external tools to interact with your org-roam knowledge base.

What's Here vs. What's Elsewhere

Component Location Purpose
MCP Server This repo (mcp/) HTTP/stdio API for n8n, chatbots, external tools
org-roam-api.el This repo (packages/org-roam-ai/) Elisp functions called by MCP server
org-roam-second-brain Separate repo User-facing Emacs packages (vector-search, second-brain)

Architecture

┌─────────────────────────────────────────────────────────────────┐
│  org-roam-second-brain (separate package)                       │
│  - org-roam-vector-search.el: Semantic search & embeddings      │
│  - org-roam-second-brain.el: Structured notes & surfacing       │
│  - Install via: (straight-use-package                           │
│      '(org-roam-second-brain :host github                       │
│        :repo "dcruver/org-roam-second-brain"))                  │
└────────────────────────┬────────────────────────────────────────┘
                         │ provides semantic search functions
┌────────────────────────▼────────────────────────────────────────┐
│  org-roam-api.el (this repo)                                    │
│  - API wrapper functions (my/api-*)                             │
│  - Used by MCP server via emacsclient                           │
└────────────────────────┬────────────────────────────────────────┘
                         │ emacsclient --eval
┌────────────────────────▼────────────────────────────────────────┐
│  org-roam-mcp (Python) - MCP Server                             │
│  - HTTP server on port 8001                                     │
│  - JSON-RPC 2.0 protocol                                        │
│  - Tools: semantic_search, create_note, contextual_search, etc. │
│  - Used by: n8n workflows, Matrix chatbots                      │
└─────────────────────────────────────────────────────────────────┘

Quick Start

For Emacs Users

Install the user-facing packages from the separate repository:

;; In your Doom config.el or init.el
(straight-use-package
  '(org-roam-second-brain :host github :repo "dcruver/org-roam-second-brain"))

(require 'org-roam-second-brain)

;; Configure embedding service
(setq org-roam-semantic-embedding-url "http://your-embedding-server:8080")
(setq org-roam-semantic-embedding-model "nomic-ai/nomic-embed-text-v1.5")

For MCP Server Deployment

See mcp/README.md for MCP server installation and deployment.

Quick deploy to a server:

# Build wheel
cd mcp && python -m build

# Copy to server
scp dist/org_roam_mcp-*.whl user@server:/tmp/

# Install on server
ssh user@server
pip install /tmp/org_roam_mcp-*.whl
org-roam-mcp  # Starts on port 8001

Required on MCP server:

  1. Emacs with org-roam configured
  2. Emacs daemon running (emacs --daemon)
  3. org-roam-second-brain package installed in Emacs
  4. org-roam-api.el loaded (copy from this repo to your doom config)

Repository Structure

org-roam-ai/
├── mcp/                           # MCP Server (Python)
│   ├── src/org_roam_mcp/         # Server source code
│   ├── pyproject.toml            # Package configuration
│   └── README.md                 # MCP-specific documentation
│
├── packages/org-roam-ai/          # API functions for MCP
│   └── org-roam-api.el           # my/api-* functions
│
└── README.md                      # This file

MCP Tools Available

Tool Description
semantic_search Vector-based semantic search
contextual_search Keyword search with context
search_notes Basic title/content search
create_note Create new org-roam note
add_daily_entry Add entry to daily note
add_inbox_entry Log to inbox for audit trail
sync_database Sync org-roam database

Related Repositories

License

GPL-3.0

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Org Roam AI

How do I install Org Roam AI?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Org Roam AI safe to use with an AI agent?

Its trust score is 52 out of 100 (fair). It passes 2 of the 3 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Org Roam AI still maintained?

The last commit was 7 months ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.