org-mcp-server
Verified Safeby szaffarano
Overview
A Model Context Protocol (MCP) server for org-mode knowledge management, providing search, content access, and note linking capabilities for AI agents.
Installation
nix run github:szaffarano/org-mcp-serverEnvironment Variables
- ORG_ORG__ORG_DIRECTORY
- ORG_ORG__ORG_DEFAULT_NOTES_FILE
- ORG_ORG__ORG_AGENDA_FILES
- ORG_ORG__ORG_AGENDA_TEXT_SEARCH_EXTRA_FILES
- ORG_LOGGING__LEVEL
- ORG_LOGGING__FILE
- ORG_SERVER__MAX_CONNECTIONS
- ORG_CLI__DEFAULT_FORMAT
- XDG_CONFIG_HOME
- HOME
Security Notes
The project is written in Rust, which offers strong memory safety. It interacts with the file system for org-mode files, performing checks for directory existence and file validity (`OrgConfig::validate`, `OrgMode::read_file`). Path expansion uses `shellexpand::tilde`. The primary server transport shown is `stdio()`, limiting direct network exposure to agents running locally. However, if the `org_directory` configuration is set too broadly by the user, or if `--root-directory` is used carelessly, it could potentially expose more of the file system than intended, albeit limited to read operations. The `rmcp` dependency supports HTTP transport, but this is not the default configuration shown in `main.rs`.
Similar Servers
context-portal
Manages structured project context for AI assistants and developer tools, enabling Retrieval Augmented Generation (RAG) and prompt caching within IDEs.
mem-agent-mcp
Provides a Model Context Protocol (MCP) server for a memory agent, enabling LLMs to interact with an Obsidian-like memory system for contextual assistance and RAG.
mcp-obsidian
Provides a secure, universal AI bridge for Obsidian vaults, enabling MCP-compatible AI assistants to read, write, and manage notes.
rust-docs-mcp
Provides AI agents with deep, cached access to Rust crate documentation, source code, and project structure for enhanced development.