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 NOASSERTION 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. It has been installed 0 times through Conduid.

Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx 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.

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 presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

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 mirrored from the source repository yesterday. The original is authoritative.

Questions

About Org Roam AI

How do I install Org Roam AI?

Run npx org-roam-ai, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

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

Its trust score is 52 out of 100 (fair). It passes 0 of 1 static security checks; 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, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.