MCPgee
MCPgee
MCPgeeMCPgee

Emacs Org-Mode

v1.0.0•Knowledge & Memory•stable

Emacs Org-mode integration with Model Context Protocol (MCP) for AI-assisted task management

agentemacs-orgmodeknowledge-basemcpmcp-server
Share:
54
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Emacs Org-Mode?

Emacs Org-Mode is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to emacs org-mode integration with model context protocol (mcp) for ai-assisted task management

Emacs Org-mode integration with Model Context Protocol (MCP) for AI-assisted task management

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Emacs Org-mode integration with Model Context Protocol (MCP)

Use Cases

Manage tasks with Emacs Org-mode integration. Leverage org-roam knowledge bases with AI assistance.
laurynas-biveinis

Maintainer

LicenseGPL-3.0
Languageemacs lisp
Versionv1.0.0
UpdatedMay 15, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx org

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Emacs Org-Mode

The org-mcp server integrates Emacs Org-mode with MCP-compatible AI assistants, giving them structured read and write access to your Org files. It exposes resources for reading file content, outlines, and individual headlines by path or Org ID, plus tools for creating tasks, updating TODO states, renaming headlines, editing body text, archiving subtrees, running agenda queries, and searching across files. Emacs users managing projects, notes, or knowledge bases with Org-mode and org-roam use it to let AI assistants assist with task management and knowledge retrieval.

Prerequisites

  • Emacs with Org-mode (part of Emacs core since version 22)
  • MELPA configured in Emacs for package installation
  • The mcp-server-lib Emacs package installed
  • A shell script wrapper (emacs-mcp-stdio.sh) for stdio communication
  • An MCP-compatible client such as Claude Code
1

Install org-mcp from MELPA

Inside Emacs, install the org-mcp package from MELPA using the package manager.

M-x package-install RET org-mcp RET
2

Configure allowed Org files

In your Emacs init file, set org-mcp-allowed-files to a list of absolute paths to the Org files you want the MCP server to access. Only listed files are readable or writable by AI assistants.

(setq org-mcp-allowed-files '("/path/to/tasks.org" "/path/to/notes.org"))
3

Start the MCP server inside Emacs

Start the org-mcp server from within Emacs using the mcp-server-lib command. The server must be running before your MCP client connects.

M-x mcp-server-lib-start
4

Register the server with your MCP client

Use the Claude Code CLI to register org-mcp as a user-level stdio server, pointing at your emacs-mcp-stdio.sh wrapper script.

claude mcp add -s user -t stdio org-mcp -- ~/.emacs.d/emacs-mcp-stdio.sh \
  --server-id=org-mcp --init-function=org-mcp-enable --stop-function=org-mcp-disable
5

Enable write-access safeguards

The server grants LLMs write access to your Org files. Set up automatic versioning or backups (e.g. git auto-commit on save) for your allowed files before using write tools, as AI assistants may occasionally make destructive edits.

Emacs Org-Mode Examples

Client configuration

Claude Code CLI registration for org-mcp as a user-level stdio server using the Emacs MCP stdio bridge.

{
  "mcpServers": {
    "org-mcp": {
      "command": "/home/user/.emacs.d/emacs-mcp-stdio.sh",
      "args": [
        "--server-id=org-mcp",
        "--init-function=org-mcp-enable",
        "--stop-function=org-mcp-disable"
      ]
    }
  }
}

Prompts to try

Use these prompts to manage Org-mode tasks and notes with your AI assistant.

- "Show me my agenda for today from tasks.org"
- "Add a new TODO task 'Write quarterly report' under the Work heading in tasks.org"
- "Mark the 'Fix login bug' task as DONE"
- "Search my Org files for any notes about the authentication system"
- "Show me the outline structure of notes.org"

Troubleshooting Emacs Org-Mode

MCP client cannot connect to the org-mcp server

Ensure you have run 'M-x mcp-server-lib-start' inside a running Emacs instance before attempting to connect. The Emacs process must be running and the server active before the MCP client can communicate via the stdio bridge.

Access denied to an Org file

Only files listed in org-mcp-allowed-files are accessible. Add the absolute path of the file to the list in your init.el and reload the configuration with 'M-x eval-buffer' or restart Emacs.

AI assistant deleted or corrupted Org file content

The org-mcp README explicitly warns that LLMs will occasionally attempt destructive edits. Set up git auto-commit on save for your Org files (e.g. using git-auto-commit-mode in Emacs) so you can roll back any unintended changes.

Frequently Asked Questions about Emacs Org-Mode

What is Emacs Org-Mode?

Emacs Org-Mode is a Model Context Protocol (MCP) server that emacs org-mode integration with model context protocol (mcp) for ai-assisted task management It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Emacs Org-Mode?

Follow the installation instructions on the Emacs Org-Mode GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Emacs Org-Mode?

Emacs Org-Mode works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Emacs Org-Mode free to use?

Yes, Emacs Org-Mode is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Emacs Org-Mode Alternatives — Similar Knowledge & Memory Servers

Looking for alternatives to Emacs Org-Mode? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.

MemPalace

★ 52.6k

A local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically

Kratos

★ 25.7k

🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.

Context Mode

★ 15.4k

An MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm

Memu

★ 13.7k

Memory for 24/7 proactive agents like OpenClaw.

MemOS

★ 9.3k

MemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u

Everos

★ 5.4k

Build, evaluate, and integrate long-term memory for self-evolving agents.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Knowledge & MemoryBrowse All Servers

Quick Config Preview

{ "mcpServers": { "org": { "command": "npx", "args": ["-y", "org"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Emacs Org-Mode?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides