# Claude Integration: Email Validation

URL: https://email-validation.org/integrations/claude/
Updated: 2026-11-06

> Documentation index: https://email-validation.org/llms.txt

Add our MCP server to Claude as a custom connector, then ask it to validate addresses or run a list from the chat. A connector added on claude.ai also works in Claude Desktop, and Claude Code connects with one command.

[Read the full setup guide](https://email-validation.org/docs/mcp/#claude) [Get an API key](https://email-validation.org/signin/)

- Status: Setup guide
- claude.ai, Claude Desktop and Claude Code

**Claude Code** One command

Terminal

```bash
claude mcp add --transport http email-validation https://api.email-validation.org/mcp \
  --header "Authorization: Bearer $EV_API_KEY"
```

## At a glance.

- **Status**: **Setup guide.** Not listed on a marketplace yet: you set it up yourself in a few steps, below and in the full guide.
- **For**: Claude users who check addresses while they write, research or code, and developers who want Claude Code to validate the addresses in a project’s files.
- **You need**: A Claude account (the Free plan allows one custom connector) and either a sign-in on our site or an [API key](https://email-validation.org/app/api-keys/) made for it, with a [daily credit cap](https://email-validation.org/docs/authentication/#limits). Bulk jobs need the Bulk permission.
- **Costs**: 1 credit = 1 validated address, as with any API request. Free: unknown results, API errors, malformed addresses and test addresses on sandbox.email-validation.org.
- **Full guide**: [Read the full setup guide](https://email-validation.org/docs/mcp/#claude)

## Typical uses.

- **Check an address in a chat**: Ask whether an address is a real mailbox before you add it to the CRM; Claude reads the status, reason and recommended action back to you.
- **Validate a list**: Paste a few addresses and Claude checks each one. For a longer list it can start a bulk job and report the counts by status, with a key or sign-in that allows Bulk; the results file is in your dashboard.
- **From Claude Code**: Let Claude Code check the addresses in a file of your project. A project .mcp.json reads the key from each person’s environment, so the file can be shared.

## Set it up. 4 steps.

The short version of the [full setup guide](https://email-validation.org/docs/mcp/#claude), which stays the reference when a step does not match what you see.

1. **Add a custom connector**: On claude.ai, go to Customize, Connectors and click Add custom connector. On Team and Enterprise plans an Owner adds it under Organization settings.
2. **Enter the server URL**: Name it, for example email-validation.org, and enter `https://api.email-validation.org/mcp` as the MCP server URL.
3. **Sign in, or use a key**: Choose a sign-in with the OAuth client set to Register automatically, or No sign-in with the request header `authorization` set to `Bearer` and your key (request headers are a beta not every organization has yet).
4. **Turn it on in a chat**: Click +, Connectors and turn it on for the conversation, then ask Claude to validate `accepted@sandbox.email-validation.org`.

## Good to know.

- Do not choose Use Claude’s published identity: our server does not support that method, and the sign-in fails.
- A connector’s authentication cannot be changed later: remove it and add it again.
- A signed-in app has no daily credit cap; connect with an API key that has one if you want a limit.
- In Claude Code, run `/mcp` to check the server is connected. To sign in instead of using a key, leave out the `--header` line.
- Try it first with `accepted@sandbox.email-validation.org` and the other [test addresses](https://email-validation.org/docs/test-addresses/): each returns the result its name says and costs nothing.

## Related

- [The full Claude setup guide](https://email-validation.org/docs/mcp/#claude)
- [The MCP server: tools, limits and security](https://email-validation.org/integrations/mcp/)
- [Claude Code setup, with a project .mcp.json](https://email-validation.org/docs/mcp/#claude-code)
- [ChatGPT integration](https://email-validation.org/integrations/chatgpt/)
- [All integrations](https://email-validation.org/integrations/)