How to integrate Unstructured MCP with Hermes

Connect Hermes to Unstructured MCP. Parse uploaded pdfs into clean markdown, extract invoice fields using a schema, and more using natural language, with authentication handled for you.

Unstructured logoUnstructured
Api Key

Unstructured is a document-processing service that turns files into Markdown and structured elements. It helps teams extract clean, usable data from complex documents.

9 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Unstructured account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Unstructured with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Unstructured with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Unstructured

Ask your agent to connect to Unstructured, or simply request any Unstructured-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Unstructured connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Unstructured or request any Unstructured-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Unstructured MCP server, and what's possible with it?

The Unstructured MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Unstructured account. It provides structured and secure access to document uploads, parsing, field extraction, and job management, so your agent can upload files, convert documents to Markdown or structured elements, extract defined fields, and manage processing jobs on your behalf.

  • Document uploads and reuse: Have your agent upload supported documents to temporary storage, reuse them for parsing or field extraction, download them later, or delete them when they are no longer needed.
  • Document parsing: Direct your agent to parse an uploaded or stored document into Markdown or structured elements, with the option to wait for the result or continue with a queued job.
  • Schema-based field extraction: Instruct your agent to extract schema-defined fields from an uploaded document, stored file, or completed parsing job.
  • Processing job tracking: Let your agent list processing jobs, check a job's current status and available result, and review errors when a parse or extraction task needs attention.
  • Job cleanup and cancellation: Have your agent cancel queued or processing jobs, or remove completed jobs from job listings when they're no longer needed.

Way Forward

With Unstructured connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Unstructured action and event your agent gets out of the box.

Cancel Job

Request irreversible cancellation of one queued or processing Parse or Extract job and return its immediate status snapshot; terminal jobs are unchanged.

Delete Job

Request asynchronous removal of one terminal Parse or Extract job from job listings; source and output blobs may remain temporarily.

Delete Uploaded File

Permanently delete one temporary uploaded file; related jobs remain and a queued job may fail if it has not consumed the file.

Download Uploaded File

Download the exact bytes of a previously uploaded scratch file before it expires.

Extract Fields

Extract schema-defined fields from one uploaded document, stored file, or completed Parse job, either waiting for a result or returning a queued job.

Get Job

Get the current status, error, configuration, and available result for one Parse or Extract job.

List Jobs

Return one newest-first page of Parse and Extract jobs, optionally filtered by status or operation, with a cursor for the next page.

Parse Document

Parse one uploaded or previously stored document into Markdown or structured elements; optionally extract schema-defined fields and either wait for a result or return a queued job.

Upload File

Upload one supported document to 24-hour scratch storage for reuse by Parse Document or Extract Fields.

FAQ

Frequently asked questions

Start with Unstructured.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Unstructured tool your agent needs.Free to start.

Start building