Docling MCP Server
by docling-projectio.github.docling-project/docling-mcpv3.3.0
Convert PDFs and other documents to structured formats via Docling, for AI applications.
context tax
queued
security
queued
cold start
queued
freshness
Active4d ago
Install Docling MCP server
Install in Claude Code
claude mcp add docling -e DOCLING_MCP_SERVICE_API_KEY='<docling-mcp-service-api-key>' -- uvx docling-mcpInstall in Cursor
{
"mcpServers": {
"docling": {
"command": "uvx",
"args": [
"docling-mcp"
],
"env": {
"DOCLING_MCP_SERVICE_API_KEY": "<docling-mcp-service-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"docling": {
"command": "uvx",
"args": [
"docling-mcp"
],
"env": {
"DOCLING_MCP_SERVICE_API_KEY": "<docling-mcp-service-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"docling": {
"type": "stdio",
"command": "uvx",
"args": [
"docling-mcp"
],
"env": {
"DOCLING_MCP_SERVICE_API_KEY": "<docling-mcp-service-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"docling": {
"command": "uvx",
"args": [
"docling-mcp"
],
"env": {
"DOCLING_MCP_SERVICE_API_KEY": "<docling-mcp-service-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| DOCLING_MCP_CONVERSION_MODE | — | — | Conversion mode: 'remote' (default) or 'local' (requires docling-mcp[local] extra). |
| DOCLING_MCP_SERVICE_URL | — | — | Base URL of the Docling Serve instance. Required when conversion mode is remote. |
| DOCLING_MCP_SERVICE_API_KEY | — | yes | API key for authenticating with Docling Serve. |
| DOCLING_MCP_SERVICE_TIMEOUT | — | — | Request timeout in seconds for the remote Docling Serve API. Default: 300.0. |
| DOCLING_MCP_SERVICE_MAX_RETRIES | — | — | Maximum number of retry attempts for remote API requests. Default: 3. |
| DOCLING_MCP_FALLBACK_TO_LOCAL | — | — | Set to 'true' to fall back to local conversion when Docling Serve is unreachable. |
| DOCLING_MCP_KEEP_IMAGES | — | — | Set to 'true' to retain page images in converted documents. Default: false. |
| DOCLING_MCP_IMAGES_SCALE | — | — | Image scale factor (e.g. 1.0, 2.0). Increase to avoid tensor batching errors. Default: 1.0. |
| DOCLING_MCP_DO_OCR | — | — | Set to 'false' to disable the OCR pipeline. Default: true. |
| DOCLING_MCP_DO_TABLE_STRUCTURE | — | — | Set to 'false' to disable table structure detection. Default: true. |
| DOCLING_MCP_DO_PICTURE_DESCRIPTION | — | — | 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_PRESET | — | — | 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_MODE | — | — | 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_DOCUMENTS | — | — | 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. |
Freshness
Active — last maintenance signal 4d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-06 · 4d ago · GitHub
Latest release
2026-10-06 · 4d ago · GitHub · v3.3.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-06 · 4d ago · official registry · v3.3.0
FAQ
›How do I install the Docling MCP server in Claude Code?
Run: claude mcp add docling -e DOCLING_MCP_SERVICE_API_KEY='<docling-mcp-service-api-key>' -- uvx docling-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Docling require an API key?
Yes. It expects DOCLING_MCP_SERVICE_API_KEY, of which 1 is a secret.
›Can I use Docling as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Docling in the official MCP registry?
Yes, as io.github.docling-project/docling-mcp.