How to integrate Findymail MCP with Atomic Agent

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Findymail.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Findymail account. See the Atomic Agent documentation for installation instructions.

How Atomic Agent connects to Findymail

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Findymail to Atomic Agent

1. Sign up or sign in to the Composio dashboard. Copy your API key.
2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
3. Ask Atomic Agent to do something in Findymail. It searches Composio for the right tool.
4. On first use, open the sign-in link returned in the chat. Connect your Findymail account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

The Findymail MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Findymail account. It provides structured and secure access to verified B2B contact data, so your agent can create and manage contact lists, find and verify emails, and streamline your outreach workflow automatically.

• Automated contact list management: Let your agent create new contact lists, fetch all your lists, or delete lists as your prospecting needs change.
• Precise contact discovery: Ask your agent to find and retrieve emails for prospects based on full name and company domain, making it easier to build targeted outreach campaigns.
• Bulk contact retrieval: Direct your agent to list all contacts within a specific list, enabling quick access to leads for export or follow-up.
• Email deliverability verification: Have your agent check if an email address is valid and safe to use before sending that crucial first message.
• Seamless CRM enrichment: Use verified contact details to automatically enrich your CRM, helping you keep data accurate and actionable for your sales team.

Use Findymail from Atomic Agent

With your account connected, ask Atomic Agent to work with Findymail in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.