How to integrate openFDA MCP with Hermes

Connect Hermes to openFDA MCP. Search fda adverse event reports by drug, find drug labels with active ingredients, and more using natural language, with authentication handled for you.

openFDA logoopenFDA
Api Key

openFDA is the U.S. FDA's public API for drug and medical device data. It makes regulatory, safety, labeling, and recall information easy to access.

16 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 openFDA 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 openFDA 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 openFDA 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 openFDA

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

4. Done. You're all set with a new openFDA 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 openFDA or request any openFDA-related task. It will prompt you to authenticate and authorize access.

5. Done!

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

The openFDA MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your openFDA account. It provides structured and secure access to public FDA drug and medical device datasets, so your agent can search adverse events, review drug labels and approvals, track recalls and shortages, and analyze medical device records on your behalf.

  • Drug safety and labeling research: Have your agent search drug adverse event reports, medication errors, labels, ingredients, warnings, indications, and dosage information.
  • Medical device oversight: Let the agent find device adverse events, 510(k) clearances, PMA approvals, classifications, UDI records, registrations, and listings.
  • Recall and shortage tracking: Direct your agent to search drug and device recall reports, including status, reason, recalling firm, distribution, and enforcement dates, or find current and historical drug shortages.
  • Drug approval and product research: Instruct your agent to search Drugs@FDA applications, Orange Book products, therapeutic-equivalence data, and National Drug Code directory records.
  • FDA data analysis: Have your agent count records by supported fields across drug and device datasets to compare trends, products, manufacturers, classifications, or report categories.

Way Forward

With openFDA 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 openFDA action and event your agent gets out of the box.

Query Device 510(k) Clearances

Search FDA 510(k) premarket notification clearances for medical devices, including applicants, product codes, decision data, and clearance type, or count clearances by a field.

Query Device Adverse Events

Search FDA MAUDE medical device adverse event reports, including device, patient, event, manufacturer, and narrative data, or count reports by a field.

Query Device Classifications

Search FDA medical device product classifications, including product codes, device class, specialty, regulation, and exemptions, or count classifications by a field.

Query Device COVID-19 Serology Evaluations

Search independent US government evaluations of COVID-19 serological test devices and assay results, or count evaluations by a field.

Query Device PMA Approvals

Search FDA premarket approval applications and supplements for medical devices, including applicants, trade names, product codes, and decision data, or count approvals by a field.

Query Device Recall Enforcement Reports

Search FDA medical device recall enforcement reports, including classification, status, recalling firm, reason, distribution, and enforcement dates, or count reports by a field.

Query Device Recall Records

Search FDA medical device recall records with product, root-cause, corrective-action, contact, and recall-event details, or count recall records by a field; use the enforcement-report action for Recall Enterprise System enforcement classifications and status.

Query Device Registrations and Listings

Search FDA medical device establishment registrations and device listings, including establishment types, products, proprietary names, and premarket numbers, or count records by a field.

Query Device UDI Records

Search FDA Global Unique Device Identification Database records by device identifier, brand, model, company, product code, or other fields, or count UDI records by a field.

Query Drug Adverse Events

Search FDA FAERS drug adverse event and medication error reports, or count reports by a field.

Query Drug Labels

Search prescription and over-the-counter Structured Product Labeling records, including warnings, indications, ingredients, and dosage text, or count labels by a field.

Query Drug NDC Directory

Search National Drug Code Directory product and package records by NDC, name, labeler, ingredient, route, or other fields, or count products by a field.

Query Drug Recall Enforcement Reports

Search FDA drug recall enforcement reports, including classification, status, recalling firm, reason, distribution, and enforcement dates, or count reports by a field.

Query Drugs@FDA Applications

Search Drugs@FDA applications, sponsors, products, and submissions, or count applications by a field.

Query Drug Shortages

Search current and historical FDA drug shortage records, including status, availability, presentation, company, and update dates, or count shortages by a field.

Query Orange Book Drug Products

Search Orange Book approved drug products and therapeutic-equivalence data, or count products by a field.

FAQ

Frequently asked questions

Start with openFDA.It takes 30 seconds.

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

Start building