# Parsio MCP by usefulapi

> Parsio MCP by usefulapi is an MCP server. Read mailboxes, documents and parsed data; parse text and re-parse documents in Parsio. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/parsio/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/parsio
- **MCP Registry name:** io.usefulapi/parsio
- **Listing updated:** 2026-11-13

## About

Read mailboxes, documents and parsed data; parse text and re-parse documents in Parsio.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http parsio https://parsio.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://parsio.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "parsio": {
      "url": "https://parsio.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "parsio": {
      "type": "http",
      "url": "https://parsio.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "parsio": {
      "serverUrl": "https://parsio.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "parsio": {
      "type": "http",
      "url": "https://parsio.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `parsio_list_mailboxes`: List all Parsio mailboxes (inboxes that hold documents and parsers) available to the account. Good first call to find a mailbox id. API: GET /mailboxes/.
- `parsio_get_mailbox`: Get one mailbox with its settings: name, parser type (preset), model and email address. API: GET /mailboxes/{id}.
- `parsio_list_table_fields`: List the table fields defined in a mailbox (the column names of its parsed tables). API: GET /mailboxes/{id}/tableFields.
- `parsio_list_documents`: List documents in a mailbox, newest first, with status. Filter by date range, name search or status. Paginated (per_page max 500). API: GET /mailboxes/{id}/docs.
- `parsio_get_document`: Get a parsed document as JSON, with its status and extracted fields. Use it to fetch a result after parsing_in_progress was true. API: GET /docs/{id}.
- `parsio_get_parsed_data`: Get the parsed data of documents in a mailbox, optionally for a date range. Paginated. API: GET /mailboxes/{id}/parsed.
- `parsio_list_templates`: List the parsing templates of a template-based mailbox. Paginated. API: GET /mailboxes/{id}/templates.
- `parsio_get_template`: Get one parsing template with its rules. API: GET /templates/{id}.
- `parsio_list_webhooks`: List the webhooks of a mailbox (url, event, enabled). API: GET /webhooks/mb/{mailbox_id}.
- `parsio_list_collected_emails`: List the sender email addresses a mailbox collected. API: GET /mailboxes/{id}/emails.
- `parsio_parse_text`: WRITE: create a new document in a mailbox from plain text or HTML and wait for the parsed result. It counts against the account's Parsio document quota. Works only for template-based and GPT-powered mailboxes. If it returns parsing_in_progress true, fetch the result later with parsio_get_document. API: POST /mailboxes/{id}/doc-sync.
- `parsio_reparse_document`: WRITE: queue an existing document for parsing again, for example after you change a template. The old result is replaced. API: POST /docs/{id}/parse.

## FAQ

### How do I add Parsio MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http parsio https://parsio.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/parsio-mcp-by-usefulapi
