PDF.co MCP server

by pdfdotco·io.github.pdfdotco/pdfco-mcp·v0.0.11·9 stars

No reviews yet

Official PDF.co MCP server: convert, merge, split, OCR, search and fill PDFs through the PDF.co API

A85/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A85/100

full report

Adoption

Growing

9 stars307 downloads/wk

Reviews

Write one

Nobody has reviewed PDF.co yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

PDF.co tools (38, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

ai_invoice_parser
AI Invoice Parser: Extracts data from invoices using AI. Ref: https://developer.pdf.co/api/ai-invoice-parser.md
create_fillable_formswrite action
Create new fillable form elements in a PDF document.
csv_to_pdf
Convert CSV or spreadsheet files (XLS, XLSX) to PDF. Ref: https://developer.pdf.co/api/pdf-from-document/csv.md
document_to_pdf
Convert various document types (DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, HTML, JPG, PNG, TIFF, WEBP) into PDF. Ref: https://developer.pdf.co/api/pdf-from-document/doc.md
email_to_pdfwrite action
Convert email to PDF. Ref: https://developer.pdf.co/api/pdf-from-email.md
excel_to_csv
Convert Excel(XLS, XLSX) to CSV. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/csv.md
excel_to_html
Convert Excel(XLS, XLSX) to HTML. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/html.md
excel_to_json
Convert Excel(XLS, XLSX) to JSON. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/json.md
excel_to_pdf
Convert Excel(XLS, XLSX) to PDF. Ref: https://developer.pdf.co/api/convert-from-excel/pdf.md
excel_to_txt
Convert Excel(XLS, XLSX) to TXT. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/text.md
excel_to_xml
Convert Excel(XLS, XLSX) to XML. Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards. Ref: https://developer.pdf.co/api/convert-from-excel/xml.md
extract_attachments
Extracts attachments from a source PDF file. Ref: https://developer.pdf.co/api/pdf-extract-attachments.md
fill_forms
Fill existing form fields in a PDF document.
find_table
Find tables in PDF and get their coordinates. Ref: https://developer.pdf.co/api/pdf-find/table.md
find_text
Find text in PDF and get coordinates. Supports regular expressions. Ref: https://developer.pdf.co/api/pdf-find/basic.md
get_job_check
Check the status and results of a job Status can be: - working: background job is currently in work or does not exist. - success: background job was successfully finished. - failed: background job failed for some reason (see message for more details). - aborted: background job was aborted. - unknown: unknown background job id. Available only when force is set to true for input request.
html_to_pdf
image_to_pdf
Convert various image formats (JPG, PNG, TIFF) to PDF. Ref: https://developer.pdf.co/api/pdf-from-image.md ```
pdf_add_annotations_images_fields
pdf_add_password
pdf_info_reader
Get detailed information about a PDF document - number of pages, metadata, security, form fields, and more. Ref: https://developer.pdf.co/api/pdf-info-reader.md
pdf_make_searchable
Convert scanned PDF documents or image files into a text-searchable PDF. Runs OCR and adds an invisible text layer that can be used for text search. Ref: https://developer.pdf.co/api/pdf-change-text-searchable/searchable.md
pdf_make_unsearchable
Make existing PDF document non-searchable by removing the text layer from it. Ref: https://developer.pdf.co/api/pdf-change-text-searchable/unsearchable.md
pdf_merge
Merge PDF from two or more PDF, DOC, XLS, images, even ZIP with documents and images into a new PDF. Ref: https://developer.pdf.co/api/merge/various-files.md
pdf_remove_passwordwrite action
Remove password protection from a PDF file. Ref: https://developer.pdf.co/api/pdf-password/remove.md
pdf_split
Split a PDF into multiple PDF files using page indexes or page ranges. Ref: https://developer.pdf.co/api/pdf-split/by-pages.md
pdf_to_csv
Convert PDF and scanned images into CSV representation with layout, columns, rows, and tables. Ref: https://developer.pdf.co/api/pdf-to-csv.md
pdf_to_html
Convert PDF and scanned images to HTML format. Ref: https://developer.pdf.co/api/pdf-to-html.md
pdf_to_image
Convert PDF and scanned images to various image formats (JPG, PNG, WebP, TIFF). Ref: - https://developer.pdf.co/api/pdf-to-image/jpg.md - https://developer.pdf.co/api/pdf-to-image/png.md - https://developer.pdf.co/api/pdf-to-image/webp.md - https://developer.pdf.co/api/pdf-to-image/tiff.md
pdf_to_json
Convert PDF and scanned images into JSON representation with text, fonts, images, vectors, and formatting preserved using the /pdf/convert/to/json2 endpoint. Ref: https://developer.pdf.co/api/pdf-to-json/basic.md
pdf_to_text
Convert PDF and scanned images to text with layout preserved. Ref: https://developer.pdf.co/api/pdf-to-text/basic.md
pdf_to_xls
Convert PDF and scanned images to XLS (Excel 97-2003) format. Ref: https://developer.pdf.co/api/pdf-to-excel/xls.md
pdf_to_xlsx
Convert PDF and scanned images to XLSX (Excel 2007+) format. Ref: https://developer.pdf.co/api/pdf-to-excel/xlsx.md
pdf_to_xml
Convert PDF and scanned images to XML format. Ref: https://developer.pdf.co/api/pdf-to-xml.md
read_pdf_forms_info
Extracts information about fillable PDF fields from an input PDF file. Ref: https://developer.pdf.co/api/forms/info-reader.md
upload_filewrite action
Upload a file to the PDF.co API
wait_job_completion
Wait for a job to complete
webpage_to_pdf

Public scan report

scanner v0.1.10 · 2026-10-25 · same rubric, same numbers if you re-run it

no findings

Code scan21 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 2 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How PDF.co compares

Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 85/100; higher than 75% of 3,470 Web search servers
Tools: 38; the typical Web search server has 5
Tools that change things: 11%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 9; more than 85% of 1,786 Web search servers
Downloads a week: 307; more than 77% of 827 Web search servers with a package

What its tools let an agent do: 34 read · 2 create · 1 change · 1 send or post

Install PDF.co in Claude Code, Cursor or VS Code

claude mcp add pdfco-mcp -- uvx pdfco-mcp

Add to Cursor

What the publisher says

From the PDF.co repository's README, as published. We do not edit it. Read it on GitHub

PDF.co MCP

PDF.co MCP Server provides PDF.co API functionality through the Model Context Protocol (MCP), enabling AI assistants to easily perform various PDF processing tasks.

🚀 Key Features

📄 PDF Conversion Tools

PDF → Various Formats: Convert PDFs to JSON, CSV, Text, Excel (XLS/XLSX), XML, HTML, Images (JPG/PNG/WebP/TIFF)
Various Formats → PDF: Convert documents (DOC/DOCX/RTF/TXT), spreadsheets (CSV/XLS/XLSX), images, web pages, HTML, emails (MSG/EML) to PDF
Excel Conversions: Convert Excel files to PDF

🛠️ PDF Editing & Modification

PDF Merging: Combine multiple PDF files into one
PDF Splitting: Split PDFs by specific pages or page ranges
Add Annotations & Images: Add text, links, images, shapes to PDFs
Form Operations: Read PDF form field information, fill forms, create new form elements

🔍 PDF Search & Analysis

Text Search: Search text in PDFs (supports regular expressions)
Table Detection: Find table locations and coordinates in PDFs
AI Invoice Parser: Extract invoice data using AI
PDF Information: Get detailed information including metadata, page count, security info

🔒 Security & Accessibility

Password Protection: Add/remove password protection to PDFs
Searchability: Make PDFs searchable via OCR or remove text layers
Attachment Extraction: Extract attachments from PDFs

💼 File Management

File Upload: Upload local files to PDF.co servers
Job Status Tracking: Monitor progress and results of asynchronous operations

⚙️ Configuration

🔑 Get API Key

Sign up at PDF.co website
Get your API key from the dashboard

📦 Install UV

You need to install UV (a fast Python packaging tool) to use this MCP server:

macOS and Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Alternative Installation Methods

Homebrew: brew install uv
PyPI with pipx: pipx install uv
PyPI with pip: pip install uv

For more installation options and details, see the UV installation guide.

Connect your client

Step-by-step guides with screenshots for each client are on developer.pdf.co:

Overview
Claude Desktop
ChatGPT desktop and Codex
Codex CLI
Claude Code
Cursor
VS Code

Any other client that runs local MCP servers over STDIO uses the same three values: the command uvx, the argument pdfco-mcp, and the environment variable XAPIKEY. In JSON form:

{
  "mcpServers": {
    "pdfco": {
      "command": "uvx",
      "args": ["pdfco-mcp"],
      "env": {
        "X_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Desktop apps often do not see your terminal's PATH; if the server fails to start, use the full path to uvx as the command. uvx keeps the version it first resolved, so run uvx pdfco-mcp@latest once to pick up a new release.

🔧 Available Tools

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

PDF.co: common questions

Is PDF.co MCP server safe?: Yes, by our scan: it is graded A (85/100). Read the PDF.co safety report
How do I install PDF.co?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does PDF.co need an API key?: Yes. The registry entry asks for X_API_KEY.
Is PDF.co maintained?: The last commit was 12 days ago (2026-10-23). The latest release is v0.0.11.
What can I use instead of PDF.co?: Servers from other publishers that do the same job: all2md MCP server, Zoteus MCP server and Papersgpt For Zotero MCP server.
How does PDF.co compare with other Web search MCP servers?: safety score 85/100 (higher than 75% of 3,470 Web search servers); tools 38 (the typical Web search server has 5); tools that change things 11% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to PDF.co

Same job from other publishers: the closest match first, then the best rated.

all2md
Read, convert, search, diff and outline PDF, Word, PowerPoint, HTML and 40+ formats as Markdown.
not reviewed
Growing
A
Zoteus
Zotero MCP server for Claude and ChatGPT: search, citations, safe writes, PDF passages and pages.
not reviewed
Established
A
Papersgpt For Zotero
Professional AI research tool for Zotero: chat with PDFs, whole-library search, Literature Radar, AutoPilot. 30+ LLMs or local models; built-in MCP server.
not reviewed
Established
B
Immich Photo Manager
Photo management for self-hosted Immich: search, albums, duplicates, faces, PDF reports. 94 tools.
not reviewed
Established
B
MCP Zotero
Unofficial Zotero server: search your library, add papers by DOI, import PDFs, cite in Word
not reviewed
Established
B