docsapi_key

Parsio

Parsio extracts structured data from emails, PDFs, and other documents using configurable parsers.

Verdict

Parsio extracts structured data from emails, PDFs, and documents — this MCP lets your team query parsed results, submit new documents for extraction, and inspect mailbox configurations without leaving Switchy. Sales ops can pull lead details from inbound forms, finance can retrieve invoice line items from vendor emails, and support can parse ticket metadata from forwarded messages. You'll need a Parsio API key with read and write access; parsing operations consume your account's credits, so test carefully before automating bulk workflows.

Common use cases

  • Extract invoice totals from vendor emails
  • Pull lead contact info from form submissions
  • Parse tracking numbers from shipping notifications
  • Retrieve line items from purchase order PDFs
  • Monitor parsed document status across mailboxes

Integration

Vendor
Parsio
Category
docs
Auth
API_KEY
Tools
10
Composio slug
parsio

Tools

  • Get Document

    Get one Parsio document and its mailbox-specific parsed JSON fields.

  • Get Mailbox

    Get settings and parser configuration for one Parsio mailbox.

  • List Documents

    List and filter documents in a Parsio mailbox, one page at a time.

  • List Mailboxes

    List the Parsio mailboxes available to the connected account so their IDs can be used for parsing and configuration tasks.

  • List Table Fields

    List the extraction fields configured for a Parsio mailbox.

  • Parse Text Document

    Submit plain text or HTML to an existing template-based or GPT-powered Parsio mailbox, optionally waiting for the parsed result. This operation creates document data and consumes parsing credits.

  • Reparse Document

    Queue an existing Parsio document to be parsed again. This operation consumes parsing capacity or credits and should not be retried blindly.

  • Skip Documents

    Mark one or more documents in a Parsio mailbox as skipped. This changes their processing state and cannot be undone through this toolkit.

  • Update Mailbox

    Update one or more settings on an existing Parsio mailbox. Provide at least one setting; omitted settings remain unchanged.

  • Upload Document

    Upload one file to a Parsio mailbox for parsing, optionally waiting for the parsed result. This operation creates document data and consumes parsing credits.

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations page. 2. Find Parsio in the MCP directory and click Connect. 3. Log in to your Parsio dashboard, go to Settings → API, and generate a new API key with full mailbox and document permissions. 4. Paste the key into Switchy's auth dialog and click Authorize. 5. Back in Switchy, create or open a Project where you want to use Parsio. 6. Type '@Parsio list my mailboxes' in the chat to confirm the connection — you should see a list of your configured mailboxes with their IDs and parser types. 7. To test extraction, type '@Parsio parse this email' and paste sample text; the MCP will submit it to your default mailbox and return the parsed JSON fields. 8. Remember that each parse or reparse call consumes credits from your Parsio plan, so avoid looping operations without a clear exit condition.

What teammates see: by default, memories from Parsio 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

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

List All Mailboxes

@Parsio list all my mailboxes and show me their names, IDs, and parser types.

Get Recent Documents

@Parsio list the 20 most recent documents in mailbox ID 'abc123' and include their parsed fields and processing status.

Parse Inbound Email

@Parsio parse this email body into mailbox 'sales-leads' and wait for the result: [paste email text here].

Inspect Mailbox Config

@Parsio get the configuration and field list for mailbox ID 'inv-parser' so I can see what fields it's set up to extract.

Reparse Failed Document

@Parsio reparse document ID 'doc-456' in mailbox 'support-tickets' and let me know when it finishes.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Parsio list all documents in my invoices mailbox from the last 7 days and show me which ones failed parsing

Output

Found 23 documents in the 'invoices' mailbox from the past week. 19 parsed successfully. 4 failed: two due to unexpected PDF layouts (documents #8472, #8491), one missing required fields (#8503), and one timeout during OCR (#8517). The failed documents are marked 'error' status and can be reparsed after template adjustments or manual review.

Notes

This example shows list-and-filter across document status. Parsio returns paginated results; the MCP handles iteration automatically but large mailboxes may take multiple API calls. Filtering by date and status requires the mailbox ID, which the MCP resolves from the mailbox name you provide.

Prompt

@Parsio parse this email body as a new document in my 'customer-orders' mailbox and wait for the extracted fields

Output

Document created (ID: doc_9x4k2m). Parsing completed in 3.2 seconds. Extracted fields: order_number='ORD-2847', customer_email='sarah@example.com', total_amount='$342.50', line_items=[3 products]. This operation consumed 1 parsing credit from your account balance (47 credits remaining this month).

Notes

This write operation submits text to Parsio's parser and waits for results, which can take 2–10 seconds depending on document complexity. Each parse consumes account credits. If the mailbox uses a GPT-powered parser, costs and latency may be higher. Do not retry failed parses without checking your credit balance and parser configuration first.

Prompt

@Parsio get the parser configuration for my 'receipts' mailbox, then summarize what fields it extracts and whether it uses AI or template rules

Output

The 'receipts' mailbox (ID: mbx_7h3p) uses a GPT-4-powered parser with 8 extraction fields: merchant_name, transaction_date, total, tax, payment_method, receipt_number, line_items (array), and notes. No template rules are configured—this mailbox relies entirely on AI inference. Average parse time: 4.1 seconds. The mailbox has processed 1,847 documents with a 94% success rate.

Notes

This synthesis example pairs mailbox metadata with the AI's ability to interpret parser type and field schema. Parsio supports both template-based and GPT-powered parsing; understanding which mode a mailbox uses helps predict cost, speed, and accuracy. The MCP fetches configuration but does not modify parser settings—that requires the Parsio dashboard.

Use-case deep-dives

Customer support email triage

When Parsio wins for inbound support ticket extraction

A 6-person support team receives 200+ emails daily—refund requests, bug reports, feature asks—all forwarded to a shared Parsio mailbox. The team uses List Documents each morning to pull the overnight batch, then Get Document to extract structured fields (customer ID, issue type, urgency flag) into their ticketing system. This works because Parsio's template parser handles the repetitive structure of support emails without burning LLM credits on every message. The threshold: if your emails vary wildly in format (mixed languages, attachments with no text body), the template approach breaks down and you'll spend more time tweaking parsers than triaging tickets. For teams with predictable inbound patterns, Parsio turns email chaos into queryable JSON in under 10 minutes of setup.

Invoice data extraction at month-end

Why Parsio fits recurring document workflows, not ad-hoc pulls

A 3-person finance team at a SaaS company closes books on the 5th of each month. Vendors email invoices as PDFs or HTML throughout the prior month; the team forwards them to a Parsio mailbox configured to extract vendor name, amount, date, and line items. On close day, they run List Documents filtered by date range, then Parse Text Document for any stragglers that didn't auto-parse. The win: Parsio's mailbox model means invoices flow in passively all month, no manual uploads. The catch: if you need to extract data from a one-off contract PDF right now, Parsio's async queue (Reparse Document can take minutes) feels slow compared to a synchronous OCR API. This MCP shines when document ingestion is a recurring background task, not a blocking step in a live conversation.

Lead enrichment from webinar signups

When Parsio's field mapping beats manual CSV wrangling

A 4-person growth team runs weekly webinars. Registration confirmations arrive as HTML emails with attendee details buried in tables. They forward confirmations to a Parsio mailbox, use List Table Fields to confirm the parser extracts name, company, title, and LinkedIn URL, then pull the batch with List Documents after each event. The structured output feeds directly into their CRM via Zapier. This setup works because the confirmation template is stable week-to-week, so the parser rarely needs tuning. The boundary: if your lead source changes format every campaign (different event platforms, custom landing pages), you'll spend more time in Get Mailbox reconfiguring parsers than you save on manual data entry. For teams with a small set of repeating lead sources, Parsio turns email into CRM-ready records without writing a single regex.

Frequently asked

What does the Parsio MCP do in Switchy?

It lets your team extract structured data from emails and documents using Parsio's parsing templates. You can submit text or HTML to a mailbox, retrieve parsed JSON fields, and list documents across your account. Useful when you need to turn receipts, invoices, or form submissions into queryable data without writing custom scrapers.

Do I need a Parsio API key to connect this MCP?

Yes. The MCP uses API key authentication, so you'll need to generate one from your Parsio account settings. Any team member with access to the Parsio API key can connect the MCP in Switchy. The key grants read and write access to all mailboxes and documents in that Parsio account.

Can the Parsio MCP create new parsing templates or mailboxes?

No. It reads mailbox settings and submits documents to existing templates, but it won't create or edit parser configurations. You still set up templates and extraction fields in the Parsio web app. The MCP is for runtime parsing and document retrieval, not template design.

How is this different from calling Parsio's API directly?

The MCP wraps Parsio's REST API in natural-language tools, so your team can ask "parse this invoice" instead of writing HTTP requests. You still consume the same parsing credits and hit the same rate limits. The trade-off: slightly higher latency for the convenience of conversational access.

Does using the Parsio MCP count against my Switchy plan limits?

MCP calls count toward your Switchy message quota, and each parse operation consumes credits from your Parsio subscription. If your team runs hundreds of parses per day, you'll burn through both faster. One team member should own the Parsio connection to avoid duplicate credit spend.

More docs MCPs

See all docs MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.