From 82095b5f9645be06c4fbca1adbf283e3095dd25a Mon Sep 17 00:00:00 2001
From: Wali Reheman <rw8143a@american.edu>
Date: Mon, 29 Jun 2026 09:03:58 -0400
Subject: [PATCH] docs(mcp): add pip-based Claude Desktop config
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Fixes issue #2128 — pip install path was undocumented for Claude Desktop users.
---
 packages/markitdown-mcp/README.md | 24 ++++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/packages/markitdown-mcp/README.md b/packages/markitdown-mcp/README.md
index d7e9224b4..1f0061d7b 100644
--- a/packages/markitdown-mcp/README.md
+++ b/packages/markitdown-mcp/README.md
@@ -56,11 +56,27 @@ Once mounted, all files under data will be accessible under `/workdir` in the co
 
 ## Accessing from Claude Desktop
 
-It is recommended to use the Docker image when running the MCP server for Claude Desktop.
+Follow [these instructions](https://modelcontextprotocol.io/quickstart/user#for-claude-desktop-users) to access Claude's `claude_desktop_config.json` file, then add the appropriate entry for your setup.
 
-Follow [these instructions](https://modelcontextprotocol.io/quickstart/user#for-claude-desktop-users) to access Claude's `claude_desktop_config.json` file.
+### Using pip
 
-Edit it to include the following JSON entry:
+If you installed `markitdown-mcp` via pip, add this to your Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "markitdown": {
+      "command": "markitdown-mcp"
+    }
+  }
+}
+```
+
+To access local files, pass `file:` URIs to the `convert_to_markdown` tool — for example, `file:///home/user/data/example.txt`.
+
+### Using Docker
+
+If you prefer Docker, the recommended configuration is:
 
 ```json
 {
@@ -78,7 +94,7 @@ Edit it to include the following JSON entry:
 }
 ```
 
-If you want to mount a directory, adjust it accordingly:
+To mount a local directory, adjust accordingly:
 
 ```json
 {