ClawLink

How to connect Lusha to Hermes Agent

Connect Lusha to Hermes with ClawLink: paste your Lusha key once and 67 tools work from chat. No MCP server to run, nothing stored on your machine.

Get started for free
Hermes Agent
Hermes Agent
ClawLink
ClawLink
Lusha
Lusha
LushaAPI KEYMCP

B2B contact enrichment and prospecting platform providing verified email addresses, phone numbers, and company information.. Once connected, Hermes Agent can read and act on Lusha from chat — pairing, token refresh, and tool wiring handled for you.

67 tools

Most guides for giving Hermes Agent Lusha access start with registering your own OAuth app or pasting API keys into env files, then leave the token refresh and tool wiring to you. ClawLink gives Hermes a more practical Lusha setup: pair once in the browser and your always-on Hermes agent can act on Lusha for you, reading and doing real work on your behalf with no auth, token refresh, or tool wiring to build yourself.

Setup

It takes three steps to connect Hermes to Lusha.

  1. 1

    Install and pair

    Install the ClawLink plugin, then pair Hermes with a one-time browser approval:

    hermes plugins install ClawLink-HQ/hermes-plugin --enable
  2. 2

    Connect Lusha

    Paste your API key in the dashboard.

  3. 3

    Use it from chat

    Ask Hermes Agent: "What can you do with Lusha?"

Install by command

The prompt above walks Hermes through this. By hand, it is four commands and a browser approval:

hermes plugins install ClawLink-HQ/hermes-plugin --enable
hermes clawlink begin    # prints an approval link — open it and approve
hermes clawlink finish   # after approving in the browser
hermes clawlink test

Then connect Lusha in the ClawLink dashboard — paste your Lusha API key once.

Verify the connection by asking Hermes:

Use Lusha to enrich contacts and walk me through the result in plain English.

Using a different agent?

The Hermes plugin is one client of ClawLink's MCP server. Claude Code, Cursor, Codex, or any agent that can run a shell command pairs with the same ClawLink account through the CLI:

npx -y @useclawlink/cli login

login opens the same browser approval and stores a credential locally. Once Lusha is connected in the dashboard, that agent calls the same 67 Lusha tools over MCP. Full setup for MCP clients and shell agents: connect apps to any AI agent.

Lusha MCP for Hermes

Looking for a Lusha MCP server for Hermes Agent? ClawLink connects Lusha to Hermes Agent and exposes 67 Lusha tools your agent can call over MCP, with hosted auth and nothing to run or maintain yourself. Using OpenClaw instead? The OpenClaw Lusha integration works the same way.

What the Hermes Agent Lusha integration can do

67 Lusha tools are ready for Hermes Agent once the account is connected. The 30 below are the ones people reach for most; your agent can call all 67.

30 of 67 Lusha tools for Hermes

ToolWhat it does
Enrich contacts lusha_enrich_contactsReveal contact data, optionally using BYOK Data Waterfall providers
Find buying group contacts lusha_find_buying_group_contactsIdentify and score buying-group contacts within target companies
Get account usage lusha_get_account_usageRetrieve the connected Lusha account's usage, limits, plan, and pricing
Get audit log stats lusha_get_audit_log_statsRetrieve aggregated audit-log delivery statistics, including total, successful and failed
Get audit logs lusha_get_audit_logsRetrieve account audit logs for API calls and webhook deliveries to review delivery status
Get companies table lusha_get_companies_tableGet a companies table's metadata, status, counts, and columns
Get companies table entities lusha_get_companies_table_entitiesRead a page of company rows and column values from a table
Get company filter values lusha_get_company_filter_valuesRetrieve valid values for one Lusha company prospecting filter
Get company icp fit scores lusha_get_company_icp_fit_scoresScore companies against the connected user's Target Profiles
Get company recommendations lusha_get_company_recommendationsReturn companies ranked for the user by Target Profiles and recent signals
Get company signal filter values lusha_get_company_signal_filter_valuesRetrieve valid values for one company signal filter
Get company signal scores lusha_get_company_signal_scoresScore companies by active buying signals
Get contact filter values lusha_get_contact_filter_valuesRetrieve valid values for one contact prospecting filter
Get contact icp fit scores lusha_get_contact_icp_fit_scoresScore contacts against user-owned or shared Lusha Target Profiles
Get contact recommendations lusha_get_contact_recommendationsReturn a user's contacts ranked against Target Profiles and recent signals
Get contact signal scores lusha_get_contact_signal_scoresScore contacts from zero to one by their active buying signals
Get contacts enrich job lusha_get_contacts_enrich_jobPoll one async contact Data Waterfall job without incurring a polling charge
Get contacts table lusha_get_contacts_tableGet a contacts table's metadata, entity count, processing status, and columns with row-status
Get contacts table entities lusha_get_contacts_table_entitiesRead one page of contacts and column values from a table
Get conversation transcript lusha_get_conversation_transcriptFetch the speaker-attributed transcript for one conversation
Get subscription lusha_get_subscriptionRetrieve a webhook subscription by ID, including its status, configuration, and entity details
Get website visits lusha_get_website_visitsReturn companies ranked by visits to the connected user's tracked sites
List companies column catalog lusha_list_companies_column_catalogList Lusha columns that can be added to a companies table
List companies tables lusha_list_companies_tablesList company tables visible to the resolved owner
List company filter types lusha_list_company_filter_typesList company prospecting filters and their query requirements
List company recommendation filters lusha_list_company_recommendation_filtersList Target Profiles and signals available to company recommendations
List company signal filters lusha_list_company_signal_filtersList company signal filters and their query requirements
List company signal types lusha_list_company_signal_typesList all supported company signal types
List contact filter types lusha_list_contact_filter_typesDiscover contact prospecting filter types and their query requirements
List contact recommendation filters lusha_list_contact_recommendation_filtersList the Target Profiles and signals available to the current user's recommendations

Try it: find the Lusha tool you need

Browse the 30 Lusha tools

Click any tool to see exactly what Hermes can do and copy a ready-to-use prompt.

Example prompts

Use Lusha to enrich contacts and walk me through the result in plain English.

The alternative to ClawLink is usually manual API key setup plus your own token handling, permission troubleshooting, and tool plumbing for Hermes Agent. That is fine if you want to build and maintain the integration yourself. Most teams just want Lusha working from chat.

ManualClawLink
Credential handlingCollect, validate, store, and rotate the Lusha API key yourself, then make sure every tool call uses the right account.Users complete the hosted ClawLink setup once and the connected Lusha account becomes available to the agent without you building credential management.
Ongoing maintenanceYou own refresh logic, permission debugging, environment config, and every provider-specific edge case for Lusha.ClawLink handles the repetitive integration plumbing so your team can focus on the workflow instead of the infrastructure.
Agent usabilityYou still need to expose the right Lusha actions to the runtime in a format your agent can reliably use.67 tools for Lusha are already exposed through ClawLink, so the agent can read and act from chat immediately.

Composio also exposes Lusha to AI agents. It is developer infrastructure: Python and TypeScript SDKs, an MCP server, and a catalog past 1,000 apps, aimed at teams shipping agent products. ClawLink is built for Hermes Agent users instead. You install the plugin once, connect Lusha in the browser, and the 67 tools above work from chat. There is no SDK and no config file, and the Lusha key you paste at setup is stored server-side rather than kept in your environment. Choosing between them? Read the full Composio alternatives comparison.

Troubleshooting

Hermes paired but still can't use Lusha

Pairing is a two-step handshake: run hermes clawlink begin, approve the link in your browser, then run hermes clawlink finish. If you ran finish before approving, or the approval link expired, run hermes clawlink begin again to get a fresh link. Confirm the plugin was installed with --enable, then verify with hermes clawlink test.

Connection succeeds but no tools appear

Reconnect Lusha from the dashboard, then start a fresh chat if the runtime still has the old tool catalog loaded.

"Tool schema not loaded yet" error when calling Lusha tools

Lusha tool schemas load on demand the first time a tool runs and are cached after that, so this error usually clears on its own: wait a few seconds and retry the same request. If every Lusha call keeps failing with it in a fresh chat, reconnect from the dashboard, and contact support if it still persists — that pattern points to a configuration problem on our side, not something you can fix by reconnecting again.

Lusha returns 403 or "permission denied" on one action while others work

Two usual causes. The connected account may not have access to the specific workspace, inbox, store, or project in the request — check that first. If access looks right, the agent may have sent a placeholder value (like "YOUR_ID" or an example id from documentation) instead of a real one: ask it to run a list or search tool first, then retry the action with a real id from those results. Most failures at this stage are one of these two, not ClawLink bugs.

API key setup works but results look incomplete

Double-check that the API key for Lusha has the right scopes or account access. A valid key can still be too limited for some reads or writes.

FAQ

Is there a Hermes Agent Lusha integration?

Yes. ClawLink is the fastest way to connect Hermes to Lusha: link your Lusha account once in the browser and Hermes Agent can call the Lusha API through 67 ready-made tools — no custom code or token handling.

How do I connect Lusha to Hermes with ClawLink?

Install the plugin with hermes plugins install ClawLink-HQ/hermes-plugin --enable, then pair once: run hermes clawlink begin, approve the link in your browser, and run hermes clawlink finish. Connect Lusha in the dashboard and Hermes can use it from the next message — no config files, and the Lusha key you paste is stored server-side instead of in your environment.

How long does it take to connect Lusha to Hermes Agent?

About two minutes. Sign in, click Connect next to Lusha in the dashboard, authenticate, and Hermes Agent can use it from the next chat message.

Why use ClawLink instead of wiring Lusha up myself?

The alternative to ClawLink is usually manual API key setup plus your own token handling, permission troubleshooting, and tool plumbing for Hermes Agent. That is fine if you want to build and maintain the integration yourself. Most teams just want Lusha working from chat.

Hermes paired but still can't use Lusha

Pairing is a two-step handshake: run hermes clawlink begin, approve the link in your browser, then run hermes clawlink finish. If you ran finish before approving, or the approval link expired, run hermes clawlink begin again to get a fresh link. Confirm the plugin was installed with --enable, then verify with hermes clawlink test.

On this page