> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hireflix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your AI tool to Hireflix with the MCP

> Let Claude, ChatGPT, Gemini, Cursor, or VS Code work in your Hireflix account. Sign in with Hireflix, no API key needed.

## What is this?

The **Hireflix MCP server** at `https://mcp.hireflix.com/mcp` connects your AI tool of choice directly to your Hireflix account. Once connected, it can look up and manage your positions, candidates, interviews, and webhooks for you. Just ask in plain English.

You don't need an API key. You sign in with your Hireflix account, and your AI tool works with **your current permissions**, so it can only see and do what you can in the dashboard. If you use Claude, that also makes the MCP simpler to set up than the [Hireflix skill](https://docs.hireflix.com/ai/skill.md), because you don't have to allow any websites in your settings.

**Quick path:**

1. [Check your plan](#supported-ai-tools): make sure your AI tool's plan supports custom MCP servers.
2. [Connect your AI tool](#connect-your-ai-tool): add the MCP URL, sign in to Hireflix, and allow access.
3. [Try it out](#try-it-out): ask a first question, then use the example prompts.

## Supported AI tools

We've tested the Hireflix MCP with these AI tools:

| AI tool | Plan you need | Good to know |
| - | - | - |
| **Claude** (recommended) | Any plan | On the free plan, you can only add **one** custom connector. If you've already added another one, remove it first or upgrade your Claude plan. |
| **ChatGPT / Codex** | **Business**, Enterprise, or Edu | You need one of these plans to both read and write through the MCP. See [OpenAI's guide to custom MCP servers](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt) for details. |
| **Gemini** (via Google Antigravity) | Any Google account | Only works in the **Google Antigravity** desktop app, not in the Gemini web app. You don't need a paid Google Workspace subscription to read and write. |

Using something else? Any AI tool that supports remote MCP servers with OAuth should be able to connect with the same URL, but we haven't tested other tools yet.

## Available tools

Once connected, your AI tool can use these Hireflix tools:

| Area | What your AI tool can do |
| - | - |
| **Positions** | List, get, create, and update positions, including intro, outro, and question videos and images |
| **Candidates** | Invite someone to a position |
| **Interviews** | List, get, score, shortlist, share, and discard interviews |
| **Webhooks** | List, create, and remove webhooks |
| **Schema tools** | Introspect, search, validate, and execute queries against the full Hireflix GraphQL schema |

> [!NOTE]
>
> Not everything you can do in Hireflix has its own tool. Fetching interview transcriptions, for example, isn't in the list above. That's what the schema tools are for: your AI tool uses **introspect** and **search** to look through the full GraphQL schema Hireflix provides, finds the query it needs, and runs it with **execute**. So if you ask for something without a dedicated tool, it can usually still do it.

See the [MCP tools reference](https://docs.hireflix.com/ai/mcp-tools.md) for every tool, its inputs, and its limits.

## Connect your AI tool

### Quick install

Pick your AI tool and click the button. It adds the Hireflix MCP to your tool, after which you sign in to Hireflix and allow access.

### Step by step

Prefer screenshots? Choose your AI tool and follow the steps. Each tool also has its own page in the [AI tools](https://docs.hireflix.com/ai/tools/claude.md) section.

> [tab] Claude (recommended)
>
> **1. Open your connector settings**
>
> In Claude, click your account name and open **Settings**. Click **Customize** in the left menu and open the **Connectors** tab. Then click the **Add** button in the top right and choose **Add custom connector**.
>
> ![The Connectors tab under Settings > Customize with the Add menu open, showing Add custom connector](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-claude-connectors-add.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=dd9952037ddfabaf77267f6dbb6dfb01)
>
> **2. Enter a name and the MCP URL**
>
> Name the connector `Hireflix` and enter the MCP server URL:
>
> ```text theme={null}
> https://mcp.hireflix.com/mcp
> ```
>
> Click **Continue**.
>
> ![The Add custom connector dialog with the name Hireflix and the URL https://mcp.hireflix.com/mcp filled in](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-connect-mcp.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=32944a21cf937322196d5750b2b421e3)
>
> **3. Keep the default connection settings**
>
> Claude detects how to connect to Hireflix and pre-fills the authentication settings (**Sign in now** and **Register automatically**). Leave them as they are and click **Add**.
>
> ![The Add custom connector dialog with the detected authentication and OAuth client settings selected](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-add-custom-connector.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=fe19b106632b229bbad51397c4dfe297)
>
> **4. Click Connect**
>
> Claude opens the **Hireflix** connector page, which tells you you're not connected to Hireflix yet. You can always find this page again under **Settings → Customize → Connectors**, in the **Yours** list. Click **Connect** to start linking your account. This opens a connection request on Hireflix. If you're not logged in to Hireflix yet, log in first.
>
> ![The Hireflix connector page in Claude showing You're not connected to Hireflix yet and a Connect button](https://mintcdn.com/hireflixsl/PL6j1Ov-vcXvxmE5/images/hireflix-userguide-connect-hireflix-flow.png?fit=max\&auto=format\&n=PL6j1Ov-vcXvxmE5\&q=85\&s=5105b8f5b40a41b127b3f28e2055c867)
>
> **5. Allow Claude to access your account**
>
> Hireflix shows what Claude will be able to do. Click **Allow** to give it access. This lets Claude:
>
> * Access your Hireflix account using your current permissions.
> * Read and manage positions, candidates, interviews, and webhooks.
> * Keep access while your session and permissions remain valid.
>
> ![The Hireflix consent screen asking to allow Claude to access your Hireflix account](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-allow-claude-hireflix.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=48d34217006063574f6211fe1ffb1b7f)
>
> That's it, you're connected. Next, [try it out](#try-it-out).
>
> > [accordion] Fine-tune tool permissions (optional)
> >
> > In Claude, go to **Settings → Customize → Connectors**, switch to **Yours**, and open **Hireflix** to choose exactly which tools Claude may use. Tools are split into **Read-only tools** and **Write/delete tools**, and for each tool you can pick:
> >
> > * **Always allow**: Claude uses the tool without asking.
> > * **Ask permission**: Claude asks you before every use. This is the default for every tool.
> > * **Block**: Claude can't use the tool at all.
> >
> > You can change a single tool, or a whole group at once using the dropdown next to the group name.
> >
> > > [!TIP]
> > >
> > > Want Claude to look things up but never change anything? Set **Read-only tools** to always allow, and block the **Write/delete tools** (or leave them on ask permission). Claude can then browse positions and interviews freely, but can't create or update positions, invite candidates, or change interview stages without you.
> >
> > ![Tool permissions for the Hireflix connector, grouped into read-only tools and write/delete tools, each with allow, ask, and block options](https://mintcdn.com/hireflixsl/LrAYsWLBx8Qr_JUp/images/hireflix-userguide-tool-permissions.png?fit=max\&auto=format\&n=LrAYsWLBx8Qr_JUp\&q=85\&s=80195f4a3c1c3bc2cf17029997c21d8e)

> [tab] ChatGPT / Codex
>
> ChatGPT and Codex use the same interface, so these steps work for both.
>
> > [!WARNING]
> >
> > **ChatGPT is known to be less reliable with MCP servers and skills than Claude.** What to expect:
> >
> > * **Large results:** asking for a lot of data at once (for example, every interview across all positions) can make ChatGPT stall or cut the answer short. Ask for smaller chunks, such as one position or the latest 10 interviews.
> > * **Slow responses:** requests can take noticeably longer, and sometimes time out.
> > * **Skipped or wrong tool calls:** ChatGPT sometimes answers without using Hireflix, or guesses the wrong fields. Tagging **Hireflix** and asking step by step helps.
> >
> > If you keep running into these issues, try Claude instead.
>
> **1. Open the Plugins page**
>
> Click **Customize** in the left menu (1), then **Plugins** (2). Click the **Add** button in the top right (3) and choose **Add custom MCP server** (4).
>
> ![The Plugins page under Customize with the Add menu open, showing Add custom MCP server](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-add-custom-mcp-server.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=188dc9830b56a9761dc9f8fe22b7f4b6)
>
> **2. Enter the server details**
>
> Fill in the form:
>
> * **Name**: `Hireflix`
>
> * **Description** (optional): `One-way video interview`
>
> * **Connection**: keep **Server URL** selected and enter the MCP server URL:
>
>   ```text theme={null}
>   https://mcp.hireflix.com/mcp
>   ```
>
> * **Authentication**: **OAuth**
>
> Don't click **Create as a plugin** yet. Click **Advanced OAuth settings** first.
>
> ![The Add custom MCP server form with the name, description, server URL, and OAuth filled in, and Advanced OAuth settings highlighted](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-add-mcp-server-form.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=2ea6348a2b1a11e72f8d63653733ff6d)
>
> **3. Remove the extra OIDC scopes**
>
> > [!WARNING]
> >
> > Don't skip this step. If you leave any other scopes in the list, the connection to Hireflix fails.
>
> With **Advanced OAuth settings** open (1), scroll all the way down in the pane on the right to **OIDC scopes supported** (2). Remove everything from the list except these two scopes:
>
> ```text theme={null}
> openid
> offline_access
> ```
>
> Leave the other settings as they are.
>
> ![Advanced OAuth settings expanded, with OIDC scopes supported showing only openid and offline\_access, and the Create as a plugin button](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-mcp-oidc-scopes.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=c092b8108a83b18bb279d7abb1916b19)
>
> **4. Create the plugin**
>
> Check **I understand and want to continue**, then click **Create as a plugin** (3 in the screenshot above).
>
> **5. Click Connect Hireflix**
>
> ChatGPT asks you to connect Hireflix. Read the information about how your data is shared, then click **Connect Hireflix**. ChatGPT redirects you to Hireflix.
>
> ![The Connect Hireflix dialog in ChatGPT with the Connect Hireflix button](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-connect-hireflix.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=52c0c791f263f18283e005e9f5294974)
>
> **6. Allow ChatGPT to access your account**
>
> If you're not logged in to Hireflix yet, log in first. Hireflix then shows what ChatGPT will be able to do for your organization. Click **Allow** to give it access. This lets ChatGPT:
>
> * Access your Hireflix account using your current permissions.
> * Read and manage positions, candidates, interviews, and webhooks.
> * Keep access while your session and permissions remain valid.
>
> ![The Hireflix consent screen asking to allow ChatGPT to access your Hireflix account](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-allow-chatgpt-hireflix.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=e0d92963038f713e22ef59158d07a2f1)
>
> **7. Check that the plugin is installed**
>
> **Hireflix** now appears under **Installed** in the **Customize** menu (1). Open it and click **Try now** (2). This opens a new chat with Hireflix already tagged.
>
> ![The Hireflix plugin page in ChatGPT, with Hireflix listed under Installed and a Try now button](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-hireflix-plugin.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=5562103b3bb68b254a1af7aa65bd79f0)
>
> That's it, you're connected. Next, [try it out](#try-it-out).

> [tab] Gemini (Antigravity)
>
> > [!WARNING]
> >
> > This **only works in Google Antigravity**, Google's desktop app for working with Gemini. You can't add the Hireflix MCP in the Gemini web app at [gemini.google.com](https://gemini.google.com). The good news: in Antigravity, a regular Google account is enough. You don't need a paid Google Workspace subscription to read and write through the MCP.
>
> **1. Download Google Antigravity**
>
> Download and install Google Antigravity from [antigravity.google/download](https://antigravity.google/download), open it, and sign in with your Google account.
>
> **2. Add the Hireflix MCP to the config file**
>
> Antigravity doesn't have a form for adding custom MCP servers yet, so you add Hireflix to its configuration file instead. Open your terminal (on macOS: press `Cmd + Space`, type **Terminal**, and press `Enter`; on Windows: open **PowerShell** from the Start menu), then copy and run the command for your operating system.
>
> ```bash macOS theme={null}
> osascript -l JavaScript -e 'ObjC.import("Foundation");const d=$.NSProcessInfo.processInfo.environment.objectForKey("HOME").js+"/.gemini/config",f=d+"/mcp_config.json";$.NSFileManager.defaultManager.createDirectoryAtPathWithIntermediateDirectoriesAttributesError(d,true,$(),$());const s=$.NSString.stringWithContentsOfFileEncodingError(f,4,$());const c=s.isNil()||!s.js.trim()?{}:JSON.parse(s.js);c.mcpServers=c.mcpServers||{};c.mcpServers.hireflix={serverUrl:"https://mcp.hireflix.com/mcp"};$(JSON.stringify(c,null,2)).writeToFileAtomicallyEncodingError(f,true,4,$());"Hireflix MCP added to "+f'
> ```
>
> ```bash Linux theme={null}
> python3 -c 'import json,os;d=os.path.expanduser("~/.gemini/config");f=d+"/mcp_config.json";os.makedirs(d,exist_ok=True);s=open(f).read() if os.path.exists(f) else "";c=json.loads(s) if s.strip() else {};c.setdefault("mcpServers",{})["hireflix"]={"serverUrl":"https://mcp.hireflix.com/mcp"};open(f,"w").write(json.dumps(c,indent=2));print("Hireflix MCP added to",f)'
> ```
>
> ```powershell Windows theme={null}
> $d="$env:USERPROFILE\.gemini\config";$f="$d\mcp_config.json";New-Item -ItemType Directory -Force $d|Out-Null;$c=if((Test-Path $f) -and "$(Get-Content $f -Raw)".Trim()){Get-Content $f -Raw|ConvertFrom-Json}else{[pscustomobject]@{}};if(-not $c.mcpServers){$c|Add-Member -Force mcpServers ([pscustomobject]@{})};$c.mcpServers|Add-Member -Force hireflix ([pscustomobject]@{serverUrl="https://mcp.hireflix.com/mcp"});[IO.File]::WriteAllText($f,($c|ConvertTo-Json -Depth 10));"Hireflix MCP added to $f"
> ```
>
> The command creates the `.gemini/config` folder and the `mcp_config.json` file if they don't exist yet, and adds Hireflix to them. If the file already exists, for example because Antigravity created it or you added other MCP servers, it keeps everything that's in there and only adds the Hireflix entry. Running it twice is safe too. When it's done, you'll see `Hireflix MCP added to` followed by the file location.
>
> > [accordion] Prefer to edit the file yourself?
> >
> > Open `~/.gemini/config/mcp_config.json` (macOS and Linux) or `%USERPROFILE%\.gemini\config\mcp_config.json` (Windows) in a text editor and add the `hireflix` entry. If the file is empty, paste in all of this:
> >
> > ```json theme={null}
> > {
> >   "mcpServers": {
> >     "hireflix": {
> >       "serverUrl": "https://mcp.hireflix.com/mcp"
> >     }
> >   }
> > }
> > ```
> >
> > If the file already lists other MCP servers, don't replace them. Add only the `hireflix` entry inside the existing `mcpServers` object.
>
> **3. Force quit and reopen Antigravity**
>
> > [!WARNING]
> >
> > Antigravity only reads the config file when it starts. Refreshing doesn't pick up the change, so you need to fully quit the app.
>
> On macOS, press `Cmd + Q` (or use **Force Quit** with `Option + Cmd + Esc`). On Windows or Linux, close the app and make sure it's no longer running. Then open Antigravity again.
>
> **4. Open your installed customizations**
>
> Click **Customizations** in the left menu (1), then switch to **Installed** in the top right (2).
>
> ![The Customizations page in Antigravity with the Installed tab selected, showing the built-in plugins and skills](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-customizations-installed.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=3ef4d5acba3c0bac07bdc3ce07eed72d)
>
> **5. Click Authenticate**
>
> Scroll all the way down to the **MCP Servers** section. You'll see **hireflix** with a red dot and the error `Unauthorized`. That's expected: Antigravity found the server, but you haven't signed in yet. Click **Authenticate**. This opens Hireflix in your browser. If you're not logged in to Hireflix yet, log in first.
>
> ![The MCP Servers section in Antigravity showing hireflix with a red dot, an Unauthorized error, and an Authenticate button](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-mcp-unauthorized.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=d41c64b77901c2dc3cdd917ee61a7e82)
>
> **6. Allow Antigravity to access your account**
>
> Hireflix shows what Google Antigravity will be able to do. Click **Allow** to give it access. This lets Antigravity:
>
> * Access your Hireflix account using your current permissions.
> * Read and manage positions, candidates, interviews, and webhooks.
> * Keep access while your session and permissions remain valid.
>
> ![The Hireflix consent screen asking to allow Google Antigravity to access your Hireflix account](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-allow-antigravity-hireflix.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=9aa855384807afed08c423d87ce44c37)
>
> **7. Copy the authorization code**
>
> Your browser now shows a Google Antigravity page with an authorization code. Click **Copy to Clipboard**.
>
> ![The Google Antigravity page in the browser showing an authorization code and a Copy to Clipboard button](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-auth-code.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=c425aa0ff7625c19775ee8a32508be4b)
>
> **8. Paste the code in Antigravity**
>
> Go back to the Antigravity app and paste the code into the **authorization code** field. If it worked, **hireflix** now has a green dot (1) and shows **18 tools enabled** (2).
>
> ![The MCP Servers section in Antigravity showing hireflix with a green dot, a Sign out button, and 18 tools enabled](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-mcp-connected.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=bebcb64fcef01d0bca2907acb6639396)
>
> That's it, you're connected. Next, [try it out](#try-it-out).
>
> > [accordion] See the Antigravity flow from first prompt to result
> >
> > Click **New Conversation** (1) and type `@hireflix` followed by your question (2), for example:
> >
> > ```text theme={null}
> > @hireflix show all positions in my account
> > ```
> >
> > ![A new conversation in Antigravity with the prompt @hireflix show all positions in my account](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-new-conversation.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=14f459c6acdc3faf2ef6e9b530cebf6d)
> >
> > Antigravity asks for approval before it uses a Hireflix tool for the first time. Choose **Yes, and always allow in this conversation** (1) so it doesn't ask again for every step, then click **Submit** (2).
> >
> > ![The Allow using this MCP tool prompt in Antigravity for hireflix/ListPositions, with options to allow once, always in this conversation, always, or not at all](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-allow-mcp-tool.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=6ca1510aaaeb583a46b2c209532e6040)
> >
> > Antigravity then lists all positions in your Hireflix account.
> >
> > ![Antigravity showing a table of the positions in the Hireflix account with name, status, tags, public, and position ID](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-mcp-chat-example.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=e3b027a3b2ef9dd39f527ef30d5538cf)

## Try it out

Start a **new** chat and ask something simple to check that the connection works:

```text theme={null}
Using the Hireflix MCP, can you list all positions in my account?
```

In ChatGPT or Codex, the chat you opened with **Try now** already has **Hireflix** tagged, so you only need to type your question. In Antigravity, start your message with `@hireflix` and allow the tool when it asks. To confirm that write access works too, follow up with a small change, such as renaming a position.

![A ChatGPT conversation where Hireflix is tagged in the message, the positions in the account are listed, and one position is renamed](https://mintcdn.com/hireflixsl/IlPJGJZkTpGn9HZB/images/hireflix-userguide-chatgpt-mcp-chat-example.png?fit=max\&auto=format\&n=IlPJGJZkTpGn9HZB\&q=85\&s=0f05960d3484a452caad8a7dcb9ef42b)

### Example prompts

Once that works, you can ask about your positions, interviews, and candidates, for example:

* "Which interviews for the `<position name>` position are completed but not yet evaluated?"
* "Give me interview stats per stage (pending, to evaluate, shortlisted, discarded) for each of my positions."
* "Summarize the answers from the latest completed interview for the `<position name>` position."
* "Fetch the transcriptions for all interviews for the `<position name>` position."
* "Can you analyze the responses for all interviews for the `<position name>` position and give me a rating for each, based on which candidate you think is best for our company?"
* "Invite `<firstname>` `<lastname>` `<email>` to the `<position name>` position."
* "Shortlist the interview from `<candidate name>` and give it a score of 4."

More ideas? See the full list of [example prompts](https://docs.hireflix.com/ai/guides/example-prompts.md).

### Creating positions

To create a position through the MCP, use the [position template](https://docs.hireflix.com/ai/guides/create-position-via-chat.md#the-position-template). Copy it, fill it in, attach any intro, outro, or question videos, and send it to your AI tool. The template follows the same input schema Hireflix expects, so your AI tool knows exactly which fields are required and what the character limits are.

## What's next?

> [card] [Create a position via chat](https://docs.hireflix.com/ai/guides/create-position-via-chat.md)
>
> Fill in one template and let your AI tool build the whole position, including videos and images.

> [card] [Interview Management](https://docs.hireflix.com/tech/features/overview.md#interview-flow)
>
> Building your own integration? Explore the full interview flow in the API docs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.