Skip to content

Perplexity via Composio with Hermes

Perplexity AI via Composio

This page describes two ways to connect Perplexity through Composio: the Composio-assisted setup and a direct MCP configuration. The exact tools and authentication screens may change, so use the current Composio dashboard and Hermes MCP documentation when they differ from this example.

Prerequisites

Ensure Hermes is installed and working on your machine or server. Install Node.js only if the Composio CLI or a selected local MCP server requires it.

Review access before connecting

Composio can connect Hermes to external accounts. Read the requested scopes, connect only the Perplexity capability you need, and do not paste API keys into chat messages or commit them to config.yaml.

  1. Install the Composio CLI from the official Composio setup page, or ask Hermes to use that setup link. The current installer command is:
curl -fsSL https://composio.dev/install | bash
  1. Prompt Hermes: "Authenticate with Composio" to link your account.

OAuth required on first use

The Composio MCP endpoint uses browser-based OAuth. Complete the first authorization in an interactive session; a headless session may require the redirect or authorization step to be completed separately.

  1. Ask Hermes to connect to Perplexity or request a read-only task such as "Find and summarize the latest official release notes for Zensical".
  2. Confirm the returned sources and the connected tool name before attempting any action that writes to an external service.

After setup, verify the connection with:

hermes mcp list

Look for a connected composio server and then run a small read-only query.

MCP Method (For Advanced/Remote Setups)

  1. Visit Connect my agent in the Composio dashboard and copy the current MCP connection instructions. Prefer the OAuth setup when it is available.
  2. Edit Hermes config file (typically ~/.hermes/config.yaml) with the URL and authentication shape supplied by Composio:
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    auth: oauth
    timeout: 180
    connect_timeout: 60
  1. Restart Hermes and run hermes mcp list.
  2. Ask for a read-only Perplexity search, then inspect the returned citations.

Verification and Tips

Inspect tools and schemas

Inspect the connected tools in Hermes before using them. Tool names and schemas are supplied by the current Composio connection and may change.

  • For cross-app workflows, connect additional apps only when the task needs them, and review each requested scope.
  • Treat Perplexity answers as research leads: open the cited sources and verify important claims independently.

Troubleshooting

If issues arise, check composio dev logs tools or the Composio docs.

Verification