Log inSubmit server
Pdfedit MCP logo

Pdfedit MCP

by @niubai

Edit existing PDFs through MCP with text replacement, redaction, insertion, deletion, form filling, and verified visual change reports.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Pdfedit MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "niubai-pdfedit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@niubai/pdfedit-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 5 tools correctly (Today).

Overview

@niubai/pdfedit-mcp connects MCP-compatible agents to the Niubai PDF Edit API for modifying existing PDF files. It supports reading text, replacing or deleting content, redacting sensitive data, inserting text, and filling forms while retaining the document's fonts and layout. Local files can be processed through the stdio package, with edited output saved beside the source and before/after images returned for each change. Reach for it when an agent needs to make targeted PDF edits rather than generate a new document.

Use cases

  • Replace company names or clauses in existing contracts
  • Redact account numbers and other sensitive text
  • Insert text into an established PDF layout
  • Fill forms in existing PDF documents
  • Inspect before-and-after images for document changes

Key features

  • Text replacement and deletion
  • PDF redaction and text insertion
  • Existing PDF form filling
  • Font and layout preservation
  • Verified edits with before-and-after images
  • Local stdio and hosted MCP access

Tools5

What Pdfedit MCP lets your agent do. Expand a tool for its parameters.

Verified live~5.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

What it can do

From the 5 tools this server returned when we ran it; 5 declare their own safety hints.

Can delete or modify data · 1Makes network requests · 5Read-only tools · 4
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age28 days
Maintainers1

Observed 2026-11-12 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9h ago via OSV.dev · @niubai/pdfedit-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads2.5kPackage downloads in the last 30 days.
Last commit2d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed5Callable tools this server registers over MCP.

How Pdfedit MCP works

What @niubai/pdfedit-mcp does

@niubai/pdfedit-mcp provides an agent-facing interface to the Niubai PDF Edit API at https://api.niubai.vip. It works with PDFs that already exist and exposes operations for reading text, replacing text, deleting content, applying redactions, inserting text, and filling forms.

The service is designed for edits that should preserve the source document's appearance. Changes retain the original fonts and layout, and each edit is checked before the resulting file is returned. The local MCP workflow writes the edited PDF next to the input file and provides a before-and-after image for every change, giving an agent a way to inspect the result.

How it works

The npm package runs as a local stdio MCP server. An MCP client starts it with npx, and the agent sends PDF editing requests through the exposed interface. Local file paths can be used with this setup.

A hosted MCP endpoint is also available for web clients that cannot run a local process. That endpoint accepts PDF URLs rather than local files:

https://pdfedit-mcp-remote.niubai-pdfedit-remote-worker.workers.dev/mcp

The service can be tried without an API key, with a limit of 20 pages per day per IP. Outputs from that no-key mode are marked SAMPLE. A free API key increases the allowance to 200 pages per month and removes the watermark from ordinary documents.

Setup and configuration

Install and register the package with an MCP client using:

Terminal
npx -y @niubai/pdfedit-mcp

For Claude Code, the registration command is:

Terminal
claude mcp add pdfedit -- npx -y @niubai/pdfedit-mcp

Cursor, VS Code, and Claude Desktop can use the equivalent stdio configuration:

config.json
{
  "pdfedit": {
    "command": "npx",
    "args": ["-y", "@niubai/pdfedit-mcp"]
  }
}

Set PDFEDIT_API_KEY when using an API key. The package also has an agent-skill distribution for environments without Node.js. Install it with npx skills add zp130221/pdfedit-mcp; the skill uses a standard-library-only Python script.

Tools and capabilities

  • Read text from existing PDF files.
  • Replace text while maintaining the document's visual structure.
  • Delete or redact selected content.
  • Insert text into an existing PDF.
  • Fill PDF forms.
  • Return edited files and visual before/after evidence for changes.

Limitations and notes

The no-key trial is limited to 20 pages per day per IP, and its generated outputs carry a SAMPLE mark. The free keyed allowance is 200 pages per month. The hosted endpoint is intended for clients that can provide PDF URLs, while the local server handles local files.

The repository and client components are MIT-licensed. The hosted Niubai API is a proprietary service. Documents are deleted within 24 hours and are not used for training.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Pdfedit MCP

@niubai/pdfedit-mcp is an MCP server that connects AI agents to the Niubai PDF Edit API. Its tools read and modify existing PDFs by replacing, deleting, redacting, inserting, and filling form text while preserving fonts and layout. It returns verified edits and before-and-after images for each change.

Install it with `npx -y @niubai/pdfedit-mcp` and register that command in your MCP client. Claude Code users can run `claude mcp add pdfedit -- npx -y @niubai/pdfedit-mcp`; Cursor, VS Code, and Claude Desktop can use the provided stdio JSON configuration.

No, an API key is not required for the trial mode. Requests without a key are limited to 20 pages per day per IP and produce outputs marked `SAMPLE`; setting `PDFEDIT_API_KEY` enables the free 200-page monthly allowance without a watermark on ordinary documents.

Yes, the local stdio server edits local PDF files and writes the result next to the original. Web clients that cannot run a local server should use the hosted MCP endpoint and provide PDF URLs instead.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPdfedit MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/niubai-pdfedit-mcp?style=directory)](https://allmcps.com/mcp/niubai-pdfedit-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/niubai-pdfedit-mcp"><img src="https://allmcps.com/api/badge/niubai-pdfedit-mcp?style=directory" alt="Pdfedit MCP on AllMCPs" /></a>