> ## 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.

# Use Hireflix in Gemini (Google Antigravity)

> Connect Gemini to your Hireflix account through the Google Antigravity desktop app, with the Hireflix MCP or the Hireflix skill.

> [!WARNING]
>
> This **only works in Google Antigravity**, Google's desktop app for working with Gemini. You can't connect Hireflix in the Gemini web app at [gemini.google.com](https://gemini.google.com). The good news: a regular Google account is enough. You don't need a paid Google Workspace subscription.

You can connect Antigravity in two ways. We recommend the **MCP**: it's faster, and you sign in with your Hireflix account instead of pasting an API key. See [MCP or skill?](https://docs.hireflix.com/ai/overview.md#mcp-or-skill) for the differences.

## Connect with the MCP (recommended)

**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)

## Use the skill

> [!TIP]
>
> **We recommend the [Hireflix MCP](https://docs.hireflix.com/ai/mcp.md) over the skill in Antigravity.** The skill works, but it's a lot slower: Gemini first has to explore the Hireflix GraphQL schema and asks for permission at almost every step. With the MCP, you don't need an API key either.

**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. Start creating a plugin**

In Antigravity, the skill becomes a **plugin**. Click **Customizations** in the left menu (1) and switch to **Installed** in the top right (2). In the **Plugins** section at the top, click **+ Create** (3). This opens a new chat with **plugin** tagged, where Antigravity's agent builds the plugin for you.

![The Customizations page in Antigravity with the Installed tab selected and the Create button in the Plugins section](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-plugin-create.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=e363b34c267a1111870a35b00c62b5e9)

**3. Optional: switch to Turbo mode**

Creating the plugin takes a while, and Antigravity asks for permission to run a lot of commands along the way. If you don't want to approve each one, click the permissions menu next to the send button (it says **Default**) (1) and choose **Turbo** (2). Antigravity then runs all commands without asking.

> [!WARNING]
>
> Turbo mode lets the agent run any command on your computer without asking first. Use it at your own risk, and switch back to **Default** when you're done.

![The Local Permissions menu in Antigravity with the options Request Review, Default, Auto, and Turbo](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-permissions-turbo.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=a7bd459bc412a791aaf767e1c598d4e3)

**4. Ask Antigravity to create the plugin from the skill file**

Replace the suggested text with this instruction, which includes the link to the Hireflix skill file, and send it (1):

```text theme={null}
Create a plugin based on this skill.md file: https://hireflixsl.mintlify.app/skill.md
```

![The plugin chat in Antigravity with the instruction to create a plugin based on the Hireflix skill.md URL](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-plugin-prompt.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=d0748f4a545f6cce620c3f563eef0f9e)

Antigravity now works through a long series of steps to build the plugin. If you're not in Turbo mode, approve each permission request when it asks.

**5. Check that the plugin is installed**

When Antigravity is done, go back to **Customizations → Installed**. **Hireflix** now appears in the **Plugins** list.

**6. Add your API key and ask a question**

Click **New Conversation**, type `@`, and pick the **Hireflix** plugin (1). Then ask your question and give it your Hireflix API key (2). See the [Quickstart](https://docs.hireflix.com/tech/quickstart.md) if you still need to create one. For example:

```text theme={null}
Can you list all positions in my account? Here's my API key: <key>
```

> [!NOTE]
>
> Also connected the [Hireflix MCP](https://docs.hireflix.com/ai/mcp.md)? Make sure you pick the **Hireflix plugin** here, not the `hireflix` MCP server.

![A new conversation in Antigravity with the Hireflix plugin tagged and a question that includes an API key placeholder](https://mintcdn.com/hireflixsl/HMnrKywD9vxbQcyD/images/hireflix-userguide-antigravity-skill-api-key-prompt.png?fit=max\&auto=format\&n=HMnrKywD9vxbQcyD\&q=85\&s=bafa88b8a3f473ebac5e5d9fb2d26a17)

Expect more permission requests here too: Gemini introspects the Hireflix GraphQL schema to find the right query before it runs it. You can approve them one by one, or switch to Turbo mode at your own risk (see step 3). This makes the skill noticeably slower than the MCP.

> [!WARNING]
>
> When you're done chatting, don't forget to rotate your key in your [API keys settings](https://admin.hireflix.com/en/my-account/api-keys).

## Try it out

Click **New Conversation** and start your message with `@hireflix`:

```text theme={null}
@hireflix show all positions in my account
```

Then try the [example prompts](https://docs.hireflix.com/ai/guides/example-prompts.md) or [create a position via chat](https://docs.hireflix.com/ai/guides/create-position-via-chat.md).


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