Gotenberg MCP. Convert anything—from Markdown notes to live URLs—into structured PDFs.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Gotenberg converts URLs, raw HTML, Markdown, and Office documents into high-quality PDFs or screenshots. It also handles complex PDF management tasks like merging multiple files, splitting large reports, reading metadata, and embedding attachments.
This MCP lets your agent manage the entire document lifecycle from source code to final, usable PDF.
What your AI agents can do
Convert html to pdf
Turns raw HTML code into a PDF file using Chromium rendering.
Convert office to pdf
Transforms Microsoft Office files (docx, xlsx, pptx) into PDFs using LibreOffice integration.
Convert markdown to pdf
Converts Markdown text directly into a PDF document.
Turns live website URLs, raw HTML code, or Markdown notes into PDF documents.
Converts Word, Excel, and PowerPoint files into a standard PDF format using LibreOffice.
Allows you to merge multiple PDFs into one file or split a single large document into smaller parts.
Reads the metadata, bookmarks, and attachments from any given PDF file.
Takes an image snapshot (screenshot) of a URL or raw HTML content instead of generating a full document.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Gotenberg: 16 Document Tools
Use these tools to perform everything from converting web content to advanced PDF manipulation like merging, splitting, and adding metadata.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Gotenberg on Vinkius019ea5efconvert html to pdf
Turns raw HTML code into a PDF file using Chromium rendering.
019ea5efconvert office to pdf
Transforms Microsoft Office files (docx, xlsx, pptx) into PDFs using LibreOffice integration.
019ea5efconvert markdown to pdf
Converts Markdown text directly into a PDF document.
019ea5efconvert url to pdf
Takes a live website URL and converts it into a PDF document.
019ea5efembed pdf attachments
Adds supplemental files or documents into an existing PDF file.
019ea5efget health
Checks the operational status of the Gotenberg service instance.
019ea5efmerge pdfs
Combines multiple separate PDF files into a single, unified document.
019ea5efread pdf bookmarks
Extracts and displays the table of contents (bookmarks) from an uploaded PDF file.
019ea5efread pdf metadata
Reads identifying information, such as creation date or author, embedded in a PDF.
019ea5efscreenshot html
Captures an image snapshot of raw HTML content instead of creating a document.
019ea5efscreenshot markdown
Takes a visual screenshot of Markdown source code for documentation purposes.
019ea5efscreenshot url
Returns an image snapshot (PNG) of the content found at a specific URL.
019ea5efsplit pdf
Splits one large PDF document into multiple, separate files based on user input.
019ea5efget version
Retrieves the current software version number for verification purposes.
019ea5efwrite pdf bookmarks
Writes a new set of bookmarks (a table of contents) to an existing PDF file.
019ea5efwrite pdf metadata
Updates or adds identifying information to the metadata layer of a PDF document.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Gotenberg, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gotenberg. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 16 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
The current process involves too much clicking and formatting guesswork.
Right now, if you need to archive a web page, you copy the URL into one tool; if you have an old report in Word format, you use another. Then, if you want to combine those two things with a new Markdown summary, you're stuck manually exporting and re-importing everything into a separate PDF editor just to get them all together.
With this MCP connector, your agent handles the entire chain. You give it the sources—the URL, the Word file, the Markdown text—and it outputs one clean, usable document in the right format, every single time.
Using Gotenberg makes PDF creation immediate and reliable.
The manual steps of converting different file types (like doing a separate conversion for `convert_office_to_pdf` vs. `convert_markdown_to_pdf`) are eliminated because your agent manages the type-specific calls behind the scenes. You just ask for 'a report' and get it.
It’s about consistency. What used to take an hour of manual file handling now happens in a single API call. Period.
What you can do with this MCP connector
Need to turn something messy—like a live website link or a chunk of raw HTML—into a clean, professional PDF? Gotenberg handles it. You give your AI client the content, and this connector spits out perfectly formatted PDFs using Chromium for rendering. It's not just about conversion; you can also take screenshots of web pages or Markdown notes when a full PDF isn't necessary.
Need to work with existing documents? Merge multiple reports into one file, split huge annual reviews into chapters, or read the hidden metadata embedded in any PDF. If your workflow requires turning diverse sources—from DOCX files to simple URLs—into structured PDFs, this is what you need. You connect it through Vinkius and let your agent handle the heavy lifting.
019ea5f0-0f4a-7229-a15a-c362a3b9e730 
How Gotenberg MCP Works
- 1 Subscribe to this MCP and enter your specific Gotenberg instance URL.
- 2 Your agent calls the relevant tool, passing the source data (e.g., an HTML string or a list of PDF files).
- 3 The service runs the conversion or manipulation, returning the finished document either as a base64 PDF file or a ZIP archive.
The bottom line is that your agent sends content to this MCP, and it gives you back a usable, processed PDF or image file.
Who Is Gotenberg MCP For?
Anyone who spends time taking information from one digital format—be it web pages, draft reports, or notes—and has to manually reformat it into standardized PDFs. This is for developers and operations staff tired of document versioning hell.
Takes Markdown files or drafts from a CMS and needs them instantly converted and formatted as polished PDF reports.
Manages compliance documents, needing to merge multiple client PDFs into a single auditable annual report.
Needs to automate the creation of invoices or technical documentation directly from code templates without manual intervention.
What Changes When You Connect
- Stop wasting time on manual conversions. Whether you use
convert_html_to_pdforconvert_markdown_to_pdf, your agent handles the formatting, guaranteeing a clean PDF every time. - Need to manage existing documents? The
merge_pdfstool lets you combine separate reports into one file without opening ten different PDFs in Acrobat. - Don't just generate; analyze. Use
read_pdf_metadataorread_pdf_bookmarksto pull structured data about the document—like who created it or what chapters exist—before processing further. - It’s not always a PDF, though. If you only need an image, use
screenshot_urlorscreenshot_htmlto grab a quick visual proof without generating a full file. - The
convert_office_to_pdftool handles the tricky stuff, taking native Word and Excel files and reliably turning them into PDF format.
Real-World Use Cases
Archiving Web Content
A marketing manager needs to save a press release page from a competitor's website. Instead of printing it or taking a blurry photo, the agent calls screenshot_url to get a clean PNG image, and then uses convert_url_to_pdf for a full archive PDF.
Consolidating Research Papers
A researcher has ten separate academic papers (PDFs) from different sources. They use the agent to call merge_pdfs, creating one master document that preserves all original structure and metadata.
Generating Code Documentation
A developer writes a new feature using raw HTML for documentation. Instead of manually pasting it into a PDF generator, they use convert_html_to_pdf to instantly create the polished technical guide.
Preparing Client Pitches
An operations team has several client-specific reports in different formats (DOCX, XLSX). They call convert_office_to_pdf on each and then use merge_pdfs to create a single, unified presentation packet.
The Tradeoffs
Trying to read file structure
Assuming you can just 'read the PDF' without knowing what data exists. You might try to process it as if it were text, leading to errors.
→
To understand a document's contents first, use read_pdf_metadata for authorship details or read_pdf_bookmarks to get the chapter structure before attempting any transformations.
Over-relying on screenshots
Using only screenshot_url when you actually need a full, searchable document. The image is useless for text extraction.
→
If the final output must be readable and editable, always use convert_url_to_pdf instead of just grabbing an image snapshot.
Forgetting the source format
Trying to merge a raw HTML file with a native DOCX file. The formats are incompatible for direct merging.
→
First, standardize your inputs. Convert all Office files using convert_office_to_pdf before attempting any document assembly tasks like merge_pdfs.
When It Fits, When It Doesn't
Use this MCP if your core problem is document transformation or assembly. If you need to take content from three different places (e.g., a website, raw code, and an old Word file) and make it into one single, standardized PDF, use the conversion tools (convert_url_to_pdf, convert_markdown_to_pdf, etc.) followed by merge_pdfs. Don't use this if your problem is simple data retrieval; for example, if you only need to know the author of a PDF, just call read_pdf_metadata and stop. If you are dealing with complex versioning or structural changes, always check the output from write_pdf_metadata first.
Common Questions About Gotenberg MCP
How do I combine multiple PDFs using merge_pdfs? +
You pass the MCP a list of the PDF files you want to include. The tool combines them into one output file, preserving their original structure and pages.
Can I convert a URL directly to a PDF? Use convert_url_to_pdf. +
Yes, convert_url_to_pdf takes any live website link and converts the entire visible page into a single PDF document.
What is the difference between screenshot_html and convert_html_to_pdf? +
screenshot_html gives you an image file (like PNG) of what the code looks like. convert_html_to_pdf creates a fully structured, printable PDF document from that same code.
Can I add metadata after creating the PDF? Use write_pdf_metadata. +
Absolutely. After you generate your core document with convert_markdown_to_pdf, you can run write_pdf_metadata to stamp it with version numbers, author names, or other identifying data.
How does convert_office_to_pdf handle non-web documents like Word or Excel? +
It converts Office files using LibreOffice integration. You simply pass the document type, and it generates a PDF format while maintaining complex layouts better than other methods.
If I have a huge report, how can the split_pdf tool help me manage sections? +
The split_pdf function breaks one large PDF into multiple files. You receive these separate documents in a ZIP archive, letting you process or share specific chapters individually.
How do I make a generated PDF navigable by adding bookmarks using write_pdf_bookmarks? +
You use the write_pdf_bookmarks tool to define internal links and structural points. Your agent can then read these defined sections with read_pdf_bookmarks, giving the end user an instant table of contents.
Can I include extra supporting files like receipts or reports using embed_pdf_attachments? +
Yes, you can embed attachments directly into the PDF structure. This keeps all related documents together in one secure file without requiring separate uploads or handling.
Can I convert a live website to a PDF with specific margins? +
Yes! Use the convert_url_to_pdf tool. You can provide the URL and optional parameters like marginTop, marginBottom, marginLeft, and marginRight to customize the output.
Is it possible to merge multiple PDF files into one? +
Absolutely. The merge_pdfs tool allows you to combine multiple PDF documents into a single file efficiently.
Can I take a screenshot of a webpage instead of a PDF? +
Yes, you can use screenshot_url for live websites or screenshot_html for raw HTML content. You can even specify the format (png, jpeg, webp) and viewport dimensions.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.