Skip to content
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 34 additions & 3 deletions packages/markitdown-mcp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,11 +56,42 @@ 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.

Edit it to include the following JSON entry:
If you installed `markitdown-mcp` with `uvx`, edit it to include the following JSON entry:

```json
{
"mcpServers": {
"markitdown": {
"command": "uvx",
"args": [
"markitdown-mcp"
]
}
}
}
```

If you installed `markitdown-mcp` with `pip` in a virtual environment, use that environment's Python executable:

```json
{
"mcpServers": {
"markitdown": {
"command": "/path/to/.venv/bin/python",
"args": [
"-m",
"markitdown_mcp"
]
}
}
}
```

Replace `/path/to/.venv/bin/python` with the absolute path to your virtual environment's Python executable. Using the absolute path avoids issues where Claude Desktop cannot find commands installed in a shell-specific `PATH`.

It is also possible to use the Docker image when running the MCP server for Claude Desktop. Edit `claude_desktop_config.json` to include the following JSON entry:

```json
{
Expand Down