Docling MCP
CommunityMCP server by docling-project · updated · ★ 776
Convert PDFs and other documents to structured formats via Docling, for AI applications. Docling MCP is a community project by docling-project, not verified by a company domain.
Last commit 3 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, 776 stars, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
DOCLING_MCP_CONVERSION_MODEEnvironment variable | Optional | Conversion mode: 'remote' (default) or 'local' (requires docling-mcp[local] extra). |
DOCLING_MCP_SERVICE_URLEnvironment variable | Optional | Base URL of the Docling Serve instance. Required when conversion mode is remote. |
DOCLING_MCP_SERVICE_API_KEYEnvironment variable, secret | Optional | API key for authenticating with Docling Serve. |
DOCLING_MCP_SERVICE_TIMEOUTEnvironment variable | Optional | Request timeout in seconds for the remote Docling Serve API. Default: 300.0. |
DOCLING_MCP_SERVICE_MAX_RETRIESEnvironment variable | Optional | Maximum number of retry attempts for remote API requests. Default: 3. |
DOCLING_MCP_FALLBACK_TO_LOCALEnvironment variable | Optional | Set to 'true' to fall back to local conversion when Docling Serve is unreachable. |
DOCLING_MCP_KEEP_IMAGESEnvironment variable | Optional | Set to 'true' to retain page images in converted documents. Default: false. |
DOCLING_MCP_IMAGES_SCALEEnvironment variable | Optional | Image scale factor (e.g. 1.0, 2.0). Increase to avoid tensor batching errors. Default: 1.0. |
DOCLING_MCP_DO_OCREnvironment variable | Optional | Set to 'false' to disable the OCR pipeline. Default: true. |
DOCLING_MCP_DO_TABLE_STRUCTUREEnvironment variable | Optional | Set to 'false' to disable table structure detection. Default: true. |
DOCLING_MCP_DO_PICTURE_DESCRIPTIONEnvironment variable | Optional | Set to 'true' to run a vision-language model to generate textual descriptions for figures and pictures. Requires a VLM to be available on the conversion backend. Default: false. |
DOCLING_MCP_PICTURE_DESCRIPTION_PRESETEnvironment variable | Optional | Preset ID for the picture-description VLM (e.g. 'smolvlm', 'granite_vision'). When unset the backend default is used. Only applies when DOCLING_MCP_DO_PICTURE_DESCRIPTION=true. |
DOCLING_MCP_IMAGE_EXPORT_MODEEnvironment variable | Optional | Controls how images are rendered when exporting to Markdown. Accepted values: 'placeholder' (default, emits <!-- image -->), 'embedded' (base64 data-URI), 'referenced' (file path / URL). |
DOCLING_MCP_CACHE_MAX_DOCUMENTSEnvironment variable | Optional | Maximum number of documents to keep in the in-memory cache. Oldest (least-recently-used) documents are evicted when the limit is reached. Default: 10. |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install Docling MCP
Built from the published package, never by AIclaude mcp add docling-mcp -- uvx docling-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"docling-mcp": {
"command": "uvx",
"args": [
"docling-mcp"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"docling-mcp": {
"command": "uvx",
"args": [
"docling-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"docling-mcp": {
"command": "uvx",
"args": [
"docling-mcp"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add docling-mcp -- uvx docling-mcp{
"mcpServers": {
"docling-mcp": {
"command": "uvx",
"args": [
"docling-mcp"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add docling-mcp uvx docling-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the docling-mcp block.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to Docling MCP
All alternatives →Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
Open-source Obsidian for MDX - edit local docs with agent assistance
A private persistent computer: files and a bash shell that survive between runs.
MCP server for terminal commands, file operations, and process management
Filesystem-first framework for durable backend AI agents that run anywhere.
W3C Web Model Context Protocol (WebMCP) API polyfill. Let AI agents like Claude, ChatGPT, and Gemini interact with your website via document.modelContext.
Docling MCP: common questions
How do I install Docling MCP?
In Claude Code run claude mcp add docling-mcp -- uvx docling-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is Docling MCP the official server?
Docling MCP is a community project by docling-project, not verified by a company domain.
Is Docling MCP free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is Docling MCP safe to use?
It scores 86 of 100. Grades: maintenance A, licence A, quality A. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to Docling MCP?
Similar MCP servers: mcp-server, Agent-Native Content, Computer, Desktop Commander.
Does Docling MCP work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
