
Docling MCP
io.github.docling-projectPublished by GitHub account docling-projectv3.5.0Updated Nov 4, 2026
Convert PDFs and other documents to structured formats via Docling, for AI applications.
Overview
Docling MCP converts PDFs and other documents into structured DoclingDocument JSON or Markdown, and lets an assistant generate new documents, locally or via…
- What you can do
- Convert PDFs and other documents into structured DoclingDocument JSON, from local files or URLs
- Generate new documents by creating a document, adding titles, headings, paragraphs and nested lists, then exporting to Markdown or saving
- Export converted or authored documents to Markdown, with configurable image handling
- Cache converted documents in memory for faster follow-up work
- Optionally run OCR, table-structure detection and vision-model picture descriptions during conversion
- Optional RAG tool groups for LlamaIndex, LlamaStack and Milvus upload and retrieval
- When to use it
- Useful when an assistant needs to read PDFs or scanned documents as structured content for summarization, extraction or RAG pipelines, or when it should draft documents in Docling's format and export them to Markdown. Choose remote mode if a Docling Serve instance is available; choose local mode for offline conversion.
- Requirements
- Runs locally as a Python package, typically launched with uvx. Remote mode (the default) needs DOCLING_MCP_SERVICE_URL and usually DOCLING_MCP_SERVICE_API_KEY for a Docling Serve instance. Local mode needs the docling-mcp[local] extra, and OCR engines must be installed on the conversion backend. Optional RAG tool groups need an LLM endpoint or LlamaStack server.
Installation
In SourceWeft
- Open Docling MCP in the dashboard and add it to a workspace.
- Enable the server for the chats that should use its tools.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Other MCP clients
Follow the launch instructions in the repository.
README
Docling MCP: making docling agentic
[CI] [PyPI version] [PyPI - Python Version] [uv] [Ruff] [Pydantic v2] [prek] [License MIT] [PyPI Downloads] [LF AI & Data] [MCP Registry] [docling-mcp MCP server] [MCP Toplist]
A document processing service using the Docling-MCP library and MCP (Model Context Protocol) for tool integration.
Overview
Docling MCP is a service that provides tools for document conversion, processing and generation. It uses the Docling library to convert PDF documents into structured formats and provides a caching mechanism to improve performance. The service exposes functionality through a set of tools that can be called by client applications.
Compatibility
If your MCP client application has not yet migrated to MCP SDK v2, pin:
See MIGRATION.md for the full migration guide.
Installation Options
Remote Mode (Recommended - Lightweight)
For users with access to Docling Serve API:
Getting Docling Serve: Visit docling-serve for installation guides. You can deploy it from published container images or look for managed Docling SaaS offerings.
Then configure your environment:
Local Mode (Full Features)
For users who need local conversion or don't have Docling Serve access:
Then configure your environment:
Hybrid Mode (Best of Both)
Install with local support and enable automatic fallback:
Configure for remote with fallback:
Features
- Conversion tools:
- PDF document conversion to structured JSON format (DoclingDocument)
- Generation tools:
- Document generation in DoclingDocument, which can be exported to multiple formats
- Local document caching for improved performance
- Support for local files and URLs as document sources
- Memory management for handling large documents
- Logging system for debugging and monitoring
- RAG applications with Milvus upload and retrieval
Configuration
All settings use the DOCLING_MCP_ prefix and can be supplied as environment
variables, in a .env file in the working directory, or via the env block of
your MCP client config. Copy .env.example as a starting point.
Conversion mode
Remote service (required when DOCLING_MCP_CONVERSION_MODE=remote)
Conversion pipeline (applies to both modes)
[!TIP] Enabling
DOCLING_MCP_DO_PICTURE_DESCRIPTION=trueadds a VLM inference step for every figure in the document. On resource-constrained hardware (e.g. a laptop running the model on CPU) this can significantly increase conversion time.
- Remote mode — increase
DOCLING_MCP_SERVICE_TIMEOUT(in seconds) to give the remote service enough time to complete. The default is300.0(5 minutes).- Local mode / MCP client timeout — the MCP client itself may also enforce a request timeout. For example, in LM Studio set the
timeoutfield (in milliseconds) in yourmcp.json:
Markdown export
Cache
LlamaIndex RAG (--tools llama-index-rag)
LlamaStack (--tools llama-stack-rag / --tools llama-stack-ie)
Setting variables in an MCP client config
Getting started
The easiest way to install Docling MCP and connect it to your client is by launching it via uvx.
Depending on the transfer protocol required, specify the argument --transport, for example
-
stdioused e.g. in Claude for Desktop and LM Studio -
sseused e.g. in Llama Stack -
streamable-httpused e.g. in containers setup
More options are available, e.g. the selection of which toolgroup to launch. Use the --help argument to inspect all the CLI options.
For developing the MCP tools further, please refer to the Developing section of CONTRIBUTING.md for instructions.
Integration with MCP clients
One of the easiest ways to experiment with the tools provided by Docling MCP is to leverage an AI desktop client with MCP support. Most of these clients use a common config interface. Adding Docling MCP in your favorite client is usually as simple as adding the following entry in the configuration file.
When using Claude for Desktop, simply edit the config file claude_desktop_config.json with the snippet above or the example provided here.
In LM Studio, edit the mcp.json file with the appropriate section or simply click on the button below for a direct install.
[Add MCP Server docling to LM Studio]
Other integrations are described in the integrations page.
Examples
Converting documents
Example of prompt for converting PDF documents:
Generating documents
Example of prompt for generating new documents:
Contributing
We welcome external contributions. See CONTRIBUTING.md for details on how to get started.
License
The Docling MCP codebase is under MIT license. For individual model usage, please refer to the model licenses found in the original packages.
LF AI & Data
Docling and Docling MCP is hosted as a project in the LF AI & Data Foundation.
IBM ❤️ Open Source AI: The project was started by the AI for knowledge team at IBM Research Zurich.
Source: README.md at commit 91e7c4f
Tools
0Version history
5- v3.5.0LatestNov 4, 2026
- v3.4.0Oct 29, 2026
- v3.3.0Oct 6, 2026
- v3.2.1Sep 24, 2026
- v3.2.0Sep 16, 2026
Score
50% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
- Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts