A python-based MCP server for your local org mode files
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"org-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
```{=org} #+CREATED: [2025-04-29 Tue 10:20] ``` ```{=org} #+UPDATED: [2025-04-29 Tue 12:57] ``` # org-mcp A python-based MCP server for your local org mode files. Allows access to your org notes, agenda, and TODOs. That said, you probably want \[org-cli\](<https://github.com/andyreagan/org-cli>) instead. I\'ll continue providing maintainence updates here, but am only actively developing on \[org-cli\](<https://github.com/andyreagan/org-cli>). <a href="https://github.com/andyreagan/org-mcp/actions/workflows/ci.yml"><img src="https://github.com/andyreagan/org-mcp/actions/workflows/ci.yml/badge.svg" alt="Tests"></a> <a href="https://badge.fury.io/py/org-mcp"><img src="https://badge.fury.io/py/org-mcp.svg" alt="PyPI version"></a> ## Tools - List org files - Read file headings - Read specific heading in file - Read whole file - Search for documents matching a specified text query across all files in the vault (including the ID link), returns matching files/headings - Add new file - Add new heading to existing file - Read agenda and TODOs from org\'s `M-x org-agenda n`{.verbatim} - Modify heading ## Example prompt - What does my day look like today? - What are the most important things for me to work on right now? - Based on my long term career and personal goals, what suggestions would a coach give me? E.g., reprioritizing open TODOs, specific actions to take. ## Adding to Claude Desktop In general, follow the instructions from Anthropic. For development: { "mcpServers": { "org-mcp": { "command": "uv", "args": [ "--directory", "<dir_to>/org-mcp", "run", "org-mcp" ] } } } To use the published version { "mcpServers": { "org-mcp": { "command": "uvx", "args": [ "org-mcp" ], "env": { "ORG_DIR" : "<YOUR_ORG_DIR>" } …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.