<p align="center">
<a href="https://github.com/docling-project/docling-mcp">
<img loading="lazy" alt="Docling" src="https://github.com/docling-project/docling-mcp/raw/main/docs/assets/docling_mcp.png" width="40%"/>
</a>
</p>
# Docling MCP: making docling agentic
[](https://pypi.org/project/docling-mcp/)
[](https://pypi.org/project/docling-mcp/)
[](https://github.com/astral-sh/uv)
[](https://github.com/astral-sh/ruff)
[](https://pydantic.dev)
[](https://github.com/pre-commit/pre-commit)
[](https://opensource.org/licenses/MIT)
[](https://pepy.tech/projects/docling-mcp)
[](https://lfaidata.foundation/projects/)
A document processing service using the Docling-MCP library and MCP (Message Control 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.
## 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
## Getting started
The easiest way to install Docling MCP is connect it to your client is launching it via [uvx](https://docs.astral.sh/uv/).
Depending on the transfer protocol required, specify the argument `--transport`, for example
- **`stdio`** used e.g. in Claude for Desktop and LM Studio
```sh
uvx --from docling-mcp docling-mcp-server --transport stdio
```
- **`sse`** used e.g. in Llama Stack
```sh
uvx --from docling-mcp docling-mcp-server --transport sse
```
- **`streamable-http`** used e.g. in containers setup
```sh
uvx --from docling-mcp docling-mcp-server --transport streamable-http
```
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 [docs/development.md](docs/development.md) page for instructions.
## Integration with Claude for Desktop
One of the easiest ways to experiment with the tools provided by Docling-MCP is to leverage [Claude for Desktop](https://claude.ai/download).
Once installed, extend Claude for Desktop so that it can read from your computer’s file system, by following the [For Claude Desktop Users](https://modelcontextprotocol.io/quickstart/user) tutorial.
To enable Claude for Desktop with Docling MCP, simply edit the config file `claude_desktop_config.json` (located at `~/Library/Application Support/Claude/claude_desktop_config.json` in MacOS) and add a new item in the `mcpServers` key with the details of a Docling MCP server. You can find an example of those details [here](docs/integrations/claude_desktop_config.json).
## Examples
### Converting documents
Example of prompt for converting PDF documents:
```prompt
Convert the PDF document at <provide file-path> into DoclingDocument and return its document-key.
```
### Generating documents
Example of prompt for generating new documents:
```prompt
I want you to write a Docling document. To do this, you will create a document first by invoking `create_new_docling_document`. Next you can add a title (by invoking `add_title_to_docling_document`) and then iteratively add new section-headings and paragraphs. If you want to insert lists (or nested lists), you will first open a list (by invoking `open_list_in_docling_document`), next add the list_items (by invoking `add_listitem_to_list_in_docling_document`). After adding list-items, you must close the list (by invoking `close_list_in_docling_document`). Nested lists can be created in the same way, by opening and closing additional lists.
During the writing process, you can check what has been written already by calling the `export_docling_document_to_markdown` tool, which will return the currently written document. At the end of the writing, you must save the document and return me the filepath of the saved document.
The document should investigate the impact of tokenizers on the quality of LLMs.
```
## 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](https://lfaidata.foundation/projects/).
**IBM ❤️ Open Source AI**: The project was started by the AI for knowledge team at IBM Research Zurich.
[docling_document]: https://docling-project.github.io/docling/concepts/docling_document/
[integrations]: https://docling-project.github.io/docling-mcp/integrations/
Raw data
{
"_id": null,
"home_page": null,
"name": "docling-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Peter Staar <taa@zurich.ibm.com>, Adel Zaalouk <azaalouk@redhat.com>, Michele Dolfi <dol@zurich.ibm.com>, Panos Vagenas <pva@zurich.ibm.com>, Christoph Auer <cau@zurich.ibm.com>, Cesar Berrospi Ramis <ceb@zurich.ibm.com>",
"keywords": "AI, Docling, RAG, agentic, agents, artificial intelligence, document understanding, mcp, message control protocol",
"author": null,
"author_email": "Peter Staar <taa@zurich.ibm.com>, Adel Zaalouk <azaalouk@redhat.com>, Michele Dolfi <dol@zurich.ibm.com>, Panos Vagenas <pva@zurich.ibm.com>, Christoph Auer <cau@zurich.ibm.com>, Cesar Berrospi Ramis <ceb@zurich.ibm.com>",
"download_url": "https://files.pythonhosted.org/packages/40/d6/7b6a47e66229156f348db04e56240cdc4382b4451d9314281585b3cbcd8a/docling_mcp-1.0.0.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <a href=\"https://github.com/docling-project/docling-mcp\">\n <img loading=\"lazy\" alt=\"Docling\" src=\"https://github.com/docling-project/docling-mcp/raw/main/docs/assets/docling_mcp.png\" width=\"40%\"/>\n </a>\n</p>\n\n# Docling MCP: making docling agentic \n\n[](https://pypi.org/project/docling-mcp/)\n[](https://pypi.org/project/docling-mcp/)\n[](https://github.com/astral-sh/uv)\n[](https://github.com/astral-sh/ruff)\n[](https://pydantic.dev)\n[](https://github.com/pre-commit/pre-commit)\n[](https://opensource.org/licenses/MIT)\n[](https://pepy.tech/projects/docling-mcp)\n[](https://lfaidata.foundation/projects/)\n\nA document processing service using the Docling-MCP library and MCP (Message Control Protocol) for tool integration.\n\n\n## Overview\n\nDocling 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.\n\n## Features\n\n- Conversion tools:\n - PDF document conversion to structured JSON format (DoclingDocument)\n- Generation tools:\n - Document generation in DoclingDocument, which can be exported to multiple formats\n- Local document caching for improved performance\n- Support for local files and URLs as document sources\n- Memory management for handling large documents\n- Logging system for debugging and monitoring\n- RAG applications with Milvus upload and retrieval\n\n## Getting started\n\nThe easiest way to install Docling MCP is connect it to your client is launching it via [uvx](https://docs.astral.sh/uv/).\n\nDepending on the transfer protocol required, specify the argument `--transport`, for example\n\n- **`stdio`** used e.g. in Claude for Desktop and LM Studio \n\n ```sh\n uvx --from docling-mcp docling-mcp-server --transport stdio\n ```\n\n- **`sse`** used e.g. in Llama Stack\n\n ```sh\n uvx --from docling-mcp docling-mcp-server --transport sse\n ```\n\n\n- **`streamable-http`** used e.g. in containers setup\n\n ```sh\n uvx --from docling-mcp docling-mcp-server --transport streamable-http\n ```\n\nMore options are available, e.g. the selection of which toolgroup to launch. Use the `--help` argument to inspect all the CLI options.\n\nFor developing the MCP tools further, please refer to the [docs/development.md](docs/development.md) page for instructions.\n\n## Integration with Claude for Desktop\n\nOne of the easiest ways to experiment with the tools provided by Docling-MCP is to leverage [Claude for Desktop](https://claude.ai/download).\nOnce installed, extend Claude for Desktop so that it can read from your computer\u2019s file system, by following the [For Claude Desktop Users](https://modelcontextprotocol.io/quickstart/user) tutorial.\n\nTo enable Claude for Desktop with Docling MCP, simply edit the config file `claude_desktop_config.json` (located at `~/Library/Application Support/Claude/claude_desktop_config.json` in MacOS) and add a new item in the `mcpServers` key with the details of a Docling MCP server. You can find an example of those details [here](docs/integrations/claude_desktop_config.json).\n\n\n## Examples\n\n### Converting documents\n\nExample of prompt for converting PDF documents:\n\n```prompt\nConvert the PDF document at <provide file-path> into DoclingDocument and return its document-key.\n```\n\n### Generating documents\n\nExample of prompt for generating new documents:\n\n```prompt\nI want you to write a Docling document. To do this, you will create a document first by invoking `create_new_docling_document`. Next you can add a title (by invoking `add_title_to_docling_document`) and then iteratively add new section-headings and paragraphs. If you want to insert lists (or nested lists), you will first open a list (by invoking `open_list_in_docling_document`), next add the list_items (by invoking `add_listitem_to_list_in_docling_document`). After adding list-items, you must close the list (by invoking `close_list_in_docling_document`). Nested lists can be created in the same way, by opening and closing additional lists.\n\nDuring the writing process, you can check what has been written already by calling the `export_docling_document_to_markdown` tool, which will return the currently written document. At the end of the writing, you must save the document and return me the filepath of the saved document.\n\nThe document should investigate the impact of tokenizers on the quality of LLMs.\n```\n\n## License\n\nThe Docling-MCP codebase is under MIT license. For individual model usage, please refer to the model licenses found in the original packages.\n\n## LF AI & Data\n\nDocling and Docling-MCP is hosted as a project in the [LF AI & Data Foundation](https://lfaidata.foundation/projects/).\n\n**IBM \u2764\ufe0f Open Source AI**: The project was started by the AI for knowledge team at IBM Research Zurich.\n\n[docling_document]: https://docling-project.github.io/docling/concepts/docling_document/\n[integrations]: https://docling-project.github.io/docling-mcp/integrations/",
"bugtrack_url": null,
"license": null,
"summary": "Running Docling as an agent using tools",
"version": "1.0.0",
"project_urls": {
"Changelog": "https://github.com/docling-project/docling-mcp/blob/main/CHANGELOG.md",
"Homepage": "https://github.com/docling-project/docling-mcp",
"Issues": "https://github.com/docling-project/docling-mcp/issues",
"Repository": "https://github.com/docling-project/docling-mcp"
},
"split_keywords": [
"ai",
" docling",
" rag",
" agentic",
" agents",
" artificial intelligence",
" document understanding",
" mcp",
" message control protocol"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d85e1887bc4c9561486a6b63b2ea036f5f8e187876c9490a006f4f8059ea754d",
"md5": "ad6005051edd9d712767b65cc12b1110",
"sha256": "88170417446b53c899cba6740959a3615c12c1429311ab9e8bf0069c01efca48"
},
"downloads": -1,
"filename": "docling_mcp-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "ad6005051edd9d712767b65cc12b1110",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 18978,
"upload_time": "2025-07-22T06:33:22",
"upload_time_iso_8601": "2025-07-22T06:33:22.378354Z",
"url": "https://files.pythonhosted.org/packages/d8/5e/1887bc4c9561486a6b63b2ea036f5f8e187876c9490a006f4f8059ea754d/docling_mcp-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "40d67b6a47e66229156f348db04e56240cdc4382b4451d9314281585b3cbcd8a",
"md5": "d762b5214100b20b748426d2fa8c2195",
"sha256": "e5c21701fd676c2c8881a9696794a9af7906f96500fb5a4b24fb3600318d5eca"
},
"downloads": -1,
"filename": "docling_mcp-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "d762b5214100b20b748426d2fa8c2195",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 17418,
"upload_time": "2025-07-22T06:33:23",
"upload_time_iso_8601": "2025-07-22T06:33:23.568471Z",
"url": "https://files.pythonhosted.org/packages/40/d6/7b6a47e66229156f348db04e56240cdc4382b4451d9314281585b3cbcd8a/docling_mcp-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-22 06:33:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "docling-project",
"github_project": "docling-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "docling-mcp"
}
JSON
