Back to Home
szaffarano icon

org-mcp-server

Verified Safe

by 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

Run Command
nix run github:szaffarano/org-mcp-server

Environment 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

Stats

Interest Score42
Security Score8
Cost ClassMedium
Avg Tokens750
Stars21
Forks2
Last Update2026-01-15

Tags

org-modeknowledge managementMCPRustfuzzy search