How to Use the Parsio MCP in Claude

Q: How do I configure the Parsio MCP Server in Claude Desktop?

Open your claudedesktopconfig.json file and add the server to the mcpServers block. Provide your Parsio API key in the environment variables, restart Claude Desktop, and the 12 parsing tools will show up under the hammer icon.

Q: What happens if a document fails to parse in my chat?

Your agent runs listparseddatahistory to inspect past extractions and identify where the template failed. See which fields missed their targets and adjust your template settings accordingly.

Run the Parsio MCP Server to extract structured data from messy PDFs and emails directly inside your Claude Desktop chat window.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Parsio MCP to Claude Desktop

Create your Vinkius account to connect Parsio to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Parsio with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automate Document Processing in Claude Desktop

`extract_data_from_file_sync` and `extract_data_from_file_async` let your agent pull clean, structured JSON from invoices or shipping manifests dropped straight into your chat. Claude Desktop processes these files locally through its stdio transport. This means your local files hit Parsio's templates without manual data entry. The sync tool handles instant extractions for files under a few megabytes while you wait. For massive batches or background runs, the async option keeps your chat free. Keep working on other tasks while Parsio processes the queue in the background.

Parse Raw Email Text and HTML Instantly

`extract_data_from_text_sync` and `extract_data_from_text_async` convert raw email bodies or HTML dumps into clean database-ready fields inside Claude Desktop. Paste the raw header and body into the chat, and your agent returns key-value pairs using your defined templates. This setup kills the need for custom regex. Your local Claude Desktop client talks to the Parsio API to match text against your templates, returning clean JSON in seconds.

Manage Mailboxes and Webhooks from Chat

`create_mailbox` and `list_mailboxes` give you full control over your document pipelines directly from the Claude Desktop interface. Spawn a new target inbox, inspect its configuration, and verify active pipelines without opening a browser tab. Use `list_mailbox_webhooks` to audit where your extracted data goes after processing. Your agent checks these endpoints to ensure your automated downstream integrations are configured correctly.

Setup guide

Set up Parsio MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Parsio MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Parsio MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under parsio-mcp.

json

{
  "mcpServers": {
    "parsio-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Parsio. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Parsio now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Parsio MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the server to the `mcpServers` block. Provide your Parsio API key in the environment variables, restart Claude Desktop, and the 12 parsing tools will show up under the hammer icon.

Yes, drop a PDF into the chat and ask your agent to parse it. The server uses `extract_data_from_file_async` to send the document to Parsio, then polls `get_parsed_document_result` until the structured JSON is ready.

No, you must create templates in the Parsio web app. Once created, Claude Desktop uses `list_mailbox_templates` and `get_template_details` to identify and apply those templates to your incoming documents.

Your agent runs `list_parsed_data_history` to inspect past extractions and identify where the template failed. See which fields missed their targets and adjust your template settings accordingly.

This MCP Server sends your files and raw text directly to Parsio's secure endpoints via HTTPS for extraction. Claude Desktop runs this server as a local subprocess, meaning your API keys and raw document data never pass through third-party servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript