PDF Blocks
PDF Blocks provides synchronous API operations for merging, splitting, watermarking, securing, and reorganizing PDF documents.
Verdict
Common use cases
- Watermark draft proposals before client review
- Merge signed contracts into one archive file
- Extract specific pages from lengthy reports
- Password-protect NDAs before external sharing
- Strip passwords from internal policy documents
Integration
- Vendor
- PDF Blocks
- Category
- docs
- Auth
- API_KEY
- Tools
- 17
- Composio slug
pdf_blocks
Tools
- Add Image Watermark
Add a PNG or JPEG image as a watermark on all or selected PDF pages.
- Add PDF Password
Create an encrypted copy of a PDF that requires a password to open.
- Add PDF Restrictions
Create an encrypted PDF copy with explicit permissions for copying, editing, printing, forms, assembly, and accessibility. Permissions are allowed by default; set an allow_* parameter to false to restrict that capability.
- Add Text Watermark
Add up to three styled text lines as a watermark on all or selected PDF pages.
- Extract PDF Pages
Create a PDF containing selected source pages in their original order.
- Merge PDFs
Merge PDF files into one PDF in the exact order provided.
- Remove PDF Pagesdestructive
Create a PDF with selected pages removed while preserving the remaining page order.
- Remove PDF Passworddestructive
Create an unencrypted copy of a password-protected PDF using its current password.
- Remove PDF Restrictionsdestructive
Create a PDF copy with permission restrictions cleared.
- Remove PDF Signaturesdestructive
Create a PDF copy with all digital signatures and timestamps removed.
- Reorder PDF Pages
Create a PDF in an exact page order, optionally dropping or repeating source pages.
- Reverse PDF Pages
Create a PDF with the complete page order reversed.
- Rotate PDF Pages
Rotate all or selected PDF pages by a supported multiple of 90 degrees.
- Split PDF at Page
Split a PDF into exactly two downloadable PDFs at a page boundary; the selected page starts the second PDF.
- Split PDF by Page Count
Split a PDF into consecutive downloadable PDFs containing up to a fixed number of pages each.
- Split PDF by Page Groups
Create one downloadable PDF for each caller-defined ordered group of source pages.
- Split PDF by Size
Split a PDF into downloadable PDFs no larger than a requested byte limit.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations. 2. Find PDF Blocks in the MCP directory and click Connect. 3. Visit the PDF Blocks dashboard, generate an API key under Account > API Keys, and copy it. 4. Paste the key into Switchy's connection dialog and click Authorize. 5. Switchy confirms the connection and shows the 17 available tools. 6. Inside any Project, type '@PDF Blocks merge these three proposals into one file' and attach the PDFs—the MCP executes the merge and returns a download link. 7. Test the connection by asking '@PDF Blocks add a text watermark saying DRAFT to this contract' with a sample PDF attached. 8. If the operation fails, check your PDF Blocks credit balance and confirm the API key has not expired.
What teammates see: by default, memories from PDF Blocks are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Watermark Draft Proposal
@PDF Blocks add a text watermark that says 'DRAFT' in gray, centered on every page of this proposal PDF.
Merge Contract Bundle
@PDF Blocks merge these three signed contracts into one PDF in the order I've attached them.
Extract Executive Summary
@PDF Blocks extract pages 1 through 5 from this quarterly report and create a new PDF.
Password-Protect NDA
@PDF Blocks add password protection to this NDA using the password 'SecureNDA2025'.
Remove Page from Invoice
@PDF Blocks remove page 3 from this invoice PDF and give me the updated file.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@pdfblocks merge the three contract drafts in our /legal folder into a single PDF, ordered by date
I've merged contract_draft_v1.pdf, contract_draft_v2.pdf, and contract_draft_v3.pdf into a single document. The combined PDF is 47 pages and preserves all original formatting. The merge operation completed successfully and the file is now available at the URL provided by PDF Blocks. This example shows how the MCP handles multi-file operations — in practice, you'd receive a download link or reference to the merged output.
This example demonstrates the merge tool, which is useful for consolidating related documents before review or distribution. The MCP requires valid API credentials and processes files synchronously, so larger PDFs may take several seconds. You'll need to handle the output URL or file reference in your workflow.
@pdfblocks add password protection to final_proposal.pdf using 'SecurePass2024' and restrict printing and editing
I've created an encrypted copy of final_proposal.pdf with the password you specified. The new PDF requires 'SecurePass2024' to open and has printing disabled and editing disabled per your request. Copying text and accessibility features remain enabled by default. The protected file is ready for distribution. This illustrative response shows how the MCP confirms both password application and permission restrictions in one operation.
This showcases the security tools — password protection and permission restrictions work together to control document access. Be aware that PDF encryption is not unbreakable, and you must communicate the password through a separate secure channel. The MCP creates a new file rather than modifying the original in place.
@pdfblocks extract pages 5-12 from the Q4_report.pdf and summarize the financial tables on those pages
I've extracted pages 5-12 from Q4_report.pdf into a new 8-page document. Reviewing the extracted content, I found three financial tables: a revenue breakdown by region showing 34% growth in APAC, an expense summary indicating a 12% reduction in operational costs, and a cash flow statement with $2.1M positive net cash from operations. The extraction preserved all table formatting and footnotes. This example pairs the MCP's page extraction with AI analysis of the resulting content.
This demonstrates how extraction enables focused analysis — the MCP pulls specific pages, then the AI can reason over that subset. Useful when working with large reports where you only need a section. The MCP doesn't parse table data itself; the AI interprets the extracted PDF content, so accuracy depends on how cleanly the tables render in the extraction.
Use-case deep-dives
When PDF Blocks beats manual watermarking for agencies
A 6-person design agency ships 40-60 client mockups per month as PDFs. Before final payment, every file needs a draft watermark; after payment, the watermark comes off and the file gets password-protected. PDF Blocks handles this in Switchy with two tools (Add Text Watermark, Add PDF Password) instead of opening Acrobat 60 times. The auth is a single API key shared across the team workspace. This works until you hit ~200 PDFs/month or need custom watermark positioning—at that scale, you want a dedicated asset pipeline. For typical agency volume, PDF Blocks turns a 90-minute monthly chore into a 10-minute batch operation.
PDF Blocks for removing sensitive pages before handoff
A 3-person HR team at a 50-employee startup needs to share employment agreements with finance, but pages 4-6 contain salary bands that can't leave HR. The Remove PDF Pages tool lets them strip those pages in Switchy without emailing the full doc to themselves, downloading, editing in Preview, re-uploading. The limitation: if you need to redact text within a page (not remove the whole page), PDF Blocks can't do it—you need a redaction-specific tool. For page-level removals before internal handoffs, this MCP saves 5-10 minutes per contract and keeps the original file out of uncontrolled inboxes. If your team processes more than 15 contracts a week, set up a shared Switchy workflow so the same Remove Pages prompt works every time.
When Merge PDFs replaces copy-paste proposal building
A 4-person sales team maintains 12 PDF modules (intro, pricing tiers, case studies, terms) and assembles custom proposals by combining 4-6 modules per deal. PDF Blocks' Merge PDFs tool lets them list the modules in Switchy and get a single proposal PDF in 30 seconds. The alternative—opening each PDF, copying pages into a new doc—takes 8-12 minutes and introduces page-order mistakes. This works cleanly until your module library exceeds 30 files or you need conditional content (if enterprise tier, include module X). At that threshold, a proposal automation platform makes more sense. For small teams with a stable module set and 10-20 proposals a month, PDF Blocks in Switchy turns proposal assembly into a one-prompt task.
Frequently asked
What does the PDF Blocks MCP let me do in Switchy?
It gives your AI agents direct access to PDF manipulation tools — merging files, extracting or removing pages, adding watermarks, setting passwords, and controlling print/copy permissions. Your team can automate document workflows without switching to a separate PDF editor or writing custom scripts.
Do I need a PDF Blocks API key to use this MCP?
Yes. The MCP authenticates via API key, so you'll need an active PDF Blocks account. Grab your key from the PDF Blocks dashboard, paste it into Switchy's connection settings, and the MCP handles the rest. No OAuth dance required.
Can the PDF Blocks MCP edit text inside an existing PDF?
No. It can add watermarks, merge files, extract or remove pages, and set encryption — but it won't rewrite paragraph text or reflow layouts. If you need to edit the actual content of a PDF, you'll still need a dedicated editor like Adobe Acrobat.
Why use this MCP instead of calling the PDF Blocks API directly?
The MCP wraps the API so your AI agents can call PDF operations in natural language without you writing integration code. You describe what you want — "merge these three contracts and password-protect the result" — and the agent picks the right tools and parameters.
Who on my team should connect the PDF Blocks MCP?
Whoever owns your PDF Blocks subscription and has the API key. Once connected in Switchy, any team member can invoke the tools through shared agents — they don't each need their own PDF Blocks account or key.