Connect Skillry MCP in Gemini CLI and Antigravity

The short answer

1Gemini CLI: run gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcp. Without --scope user it applies to the current project only.
2Antigravity: merge the skillry entry into ~/.gemini/config/mcp_config.json, then type /mcp in Antigravity CLI.
3In either tool, /mcp inside a session lists the server and its tools.

Start here:Add it Check it Authorize It isn’t working

Before you start

Checked against the official documentation on 28 October 2026. Not yet run on a real installation of this client; if a step differs on your machine, use Report an issue at the bottom.

Gemini CLI (gemini --version) or Antigravity CLI (agy) installed and signed in. If gemini tells you it has been replaced, use the Antigravity tab.
Node.js 22 or newer (node --version).

Tool	Config file	Check
Gemini CLI	`~/.gemini/settings.json` (user) or `.gemini/settings.json` (project)	`gemini mcp list` or `/mcp`
Antigravity CLI, app and IDE	`~/.gemini/config/mcp_config.json` (global) or `.agents/mcp_config.json` (workspace)	`/mcp` in the CLI; Installed MCP Servers in the app

Add Skillry to Gemini CLI or Antigravity

Fastest when you still use Gemini CLI

1
Run this in any terminal. The -- separates Gemini’s own options from the arguments passed to npx.
macOS
```
gemini mcp add --scope user --transport stdio skillry npx -- --yes skillry-cli@latest mcp
```
You should see: No error, and gemini mcp list now includes skillry.

On Windows, run this instead so Windows can start npx:

Windows (PowerShell or Command Prompt)

gemini mcp add --scope user --transport stdio skillry cmd -- /c npx --yes skillry-cli@latest mcp

3
Start a new Gemini CLI session.
You should see: skillry in the /mcp list with its tools.

When you keep your settings in the file

1
Open ~/.gemini/settings.json (for one project, .gemini/settings.json inside it).

Merge this into the mcpServers object, keeping any servers already there.

macOS

{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

On Windows use this entry instead.

Windows

{
  "mcpServers": {
    "skillry": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

4
Save and start a new session.
You should see: skillry in the /mcp list.

CLI, app and IDE read the same file

1
Open or create ~/.gemini/config/mcp_config.json. For one workspace, use .agents/mcp_config.json inside it instead.

Merge this into the mcpServers object. The format is the same as Gemini CLI’s.

macOS

{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

On Windows use this entry instead.

Windows

{
  "mcpServers": {
    "skillry": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

4
In Antigravity CLI type /mcp to open the MCP manager and refresh. In the Antigravity app open Settings, then Customizations, find Installed MCP Servers and select Refresh.
You should see: skillry listed with its tools.

Check that the connection works

1
Gemini CLI: list the configured servers.
Terminal
```
gemini mcp list
```
You should see: skillry with its command and a connected status.
2
Either tool: type /mcp in a session.
You should see: skillry with its tools, starting with search_skills.

Try your first search

Searching needs no account, so this is the quickest way to prove the connection works.

1
Start a new conversation in Gemini CLI or Antigravity and paste this request.
Prompt your agent
```
Use the Skillry MCP connected to https://skillry.dev to find three product presentation Skills. Show their preview links, required inputs, dependencies and external costs. Do not install or run anything.
```
You should see: Three Skill candidates, each with a preview link, the inputs it needs, its dependencies and any outside costs. Nothing is installed.
2
If the agent answers that it has no Skillry tool, or the request hangs, go to It isn’t working.

Authorize when you install

Installing checks your Skillry account. You do not type a password or paste a key into the agent: the first time, it opens a page in your browser and you approve it there.

1
Ask the agent to install the Skill you chose, for example Install it for this project.
You should see: The agent reports that it needs to connect your account and opens your browser. In a terminal client it may print the link instead; open it yourself.
2
Check that the device code on the page matches the one the agent shows, sign in to Skillry if asked, then select Approve.
You should see: Authorization approved, with a note to return to your agent. The agent notices within a few seconds and finishes the install.

The approval lasts 7 days and is stored in your operating system’s keyring (Keychain on macOS, Credential Manager on Windows). When it expires the agent simply asks you to approve again. To sign out early, ask the agent to disconnect your Skillry account.

If the agent can’t see Skillry

What you see	Likely cause	What to do
`gemini mcp list` is empty in another folder	The server was added with the default project scope	Add it again with `--scope user`, or move the entry to `~/.gemini/settings.json`.
`gemini` says the CLI has been replaced	Your plan was moved to Antigravity CLI	Use the Antigravity tab. The entry is the same JSON in a different file.
Antigravity does not pick the file up	The file has a JSON error, or was not refreshed	Validate the JSON, then `/mcp` in the CLI or Refresh in the app.
The server is listed but shows as failed, or never starts	`npx` is not installed, Node.js is older than 22, or the first start timed out while downloading the package	Run `node --version` and `npx --version` in a terminal. Then run `npx --yes skillry-cli@latest mcp` once by hand, wait for it to start, press Ctrl+C, and try the client again: the package is now cached.
On Windows the server exits as soon as it starts	The entry starts `npx` directly, and Windows needs a shell to run it	Use the Windows entry from this page: the command is `cmd` and the arguments start with `/c`, `npx`.
The browser page says the request is invalid or expired	The device code was approved too late, or belongs to an earlier attempt	Ask the agent to connect again and approve the new code within a few minutes.
Installing stops with a Premium or purchase message	The Skill is Premium and your account has neither a plan nor a purchase for it	Follow the link the agent shows to buy the Skill or subscribe, then ask again. Nothing is charged until you do.

Remove or disconnect

1
Gemini CLI: remove the server from your user settings.
Terminal
```
gemini mcp remove -s user skillry
```
2
Antigravity: delete the skillry entry from mcp_config.json and refresh. To keep it but stop it loading, set "disabled": true on the entry.

Removing the entry does not sign you out of Skillry. To revoke the stored approval as well, ask the agent to disconnect your Skillry account first, or remove the entry and let the approval expire after 7 days.

Reference

Item	macOS	Windows
Gemini CLI user settings	`~/.gemini/settings.json`	`%USERPROFILE%\.gemini\settings.json`
Antigravity global config	`~/.gemini/config/mcp_config.json`	`%USERPROFILE%\.gemini\config\mcp_config.json`
Launch command	`npx --yes skillry-cli@latest mcp`	`cmd /c npx --yes skillry-cli@latest mcp`
Check	`gemini mcp list` or `/mcp`	same

The entry both tools store (macOS)

{
  "mcpServers": {
    "skillry": {
      "command": "npx",
      "args": [
        "--yes",
        "skillry-cli@latest",
        "mcp"
      ]
    }
  }
}

Gemini CLI’s --scope, --timeout and --trust options are in the Gemini CLI MCP documentation; Antigravity’s file format and the app’s MCP settings are in the Antigravity MCP documentation.

Common questions

Is Gemini CLI going away?

Google moved free-tier and Google One users to Antigravity CLI on 18 June 2026; paid plans keep Gemini CLI. The Skillry entry is the same JSON in both tools.

Why --scope user?

Gemini CLI’s default scope is the current project. User scope puts the entry in ~/.gemini/settings.json, so it works in every folder.

Do the Antigravity app and CLI share the entry?

Yes. The app, the CLI and the IDE all read ~/.gemini/config/mcp_config.json.

Sources

Did this guide help?

PreviousVS Code NextClaude Desktop