# KnowMan MCP server for Google Antigravity

Client: Google Antigravity

Add a `knowman` entry to Antigravity's `mcp_config.json` using `command`, `args`, and `env`, the keys [Antigravity's MCP config](https://antigravity.google/docs/mcp/) defines for a local [stdio server](https://www.knowman.io/guides/what-is-an-mcp-server). The entry runs `npx -y @knowman/mcp` with a `KNOWMAN_API_KEY`, as documented in the [KnowMan MCP repo](https://github.com/Essatt/knowman-mcp). Once installed, the server's tools are automatically available to the editor.

## knowman entry for mcp_config.json

```json
{
  "mcpServers": {
    "knowman": {
      "command": "npx",
      "args": ["-y", "@knowman/mcp"],
      "env": {
        "KNOWMAN_API_KEY": "<key>"
      }
    }
  }
}
```

## What you need before you start

You need a [KnowMan account](https://app.knowman.io), an [API key](https://www.knowman.io/guides/mcp-server-knowledge-base), and [Node 22 or newer](https://www.npmjs.com/package/@knowman/mcp). Create the key in the web app under Settings > Connections > Connect an AI agent. See KnowMan MCP.

On the Antigravity side you need access to `mcp_config.json`. Antigravity supports MCP, an open standard that lets [AI agents](https://www.knowman.io/guides/knowledge-base-for-ai-agents) connect to local tools and remote APIs.

## Add the server to mcp_config.json

Antigravity keeps MCP config in two places. The global file `~/.gemini/config/mcp_config.json` applies to all your projects. The workspace file `<workspace>/.agents/mcp_config.json` applies to one workspace. In the IDE, open MCP Servers, click Manage MCP Servers, then View raw config to edit the file. See Antigravity MCP docs.

The root object holds an `mcpServers` map. Each entry specifies exactly one transport property, `command` for a local stdio server or `serverUrl` for a remote one. Paste the `knowman` entry from the config block above, which uses `command`, `args`, and `env` for the stdio transport. The schema is documented in the Antigravity MCP docs.

In the Antigravity App, manage servers in the MCP Servers section of the Customizations page. The Copy Config File Path button in the section header shows the file location. See Antigravity MCP docs.

## Sign in once with knowman login

You can skip pasting a key. Run `npx -p @knowman/mcp knowman login` once. It opens a browser sign-in and saves a credential that the CLI and the MCP server share, so you can drop the `env` block from the config. See KnowMan MCP.

If you prefer a key, create one in the web app under Settings > Connections > Connect an AI agent, then set it as the `KNOWMAN_API_KEY` environment variable. See KnowMan MCP.

## Verify the connection

In the CLI, type `/mcp` in the prompt panel and press Enter to open the MCP Manager Overlay. It shows status rings for active, disconnected, or loading servers, and you can reload server configurations or inspect connection logs there. See Antigravity MCP docs.

In the App, click More actions (⋮) next to the server and choose Restart, Disable, or Delete as needed. In the IDE, tools from an installed server are automatically available to the editor. Then ask the assistant to search my KnowMan for something, or to [save a URL](https://www.knowman.io/guides/how-to-save-articles). See Antigravity MCP docs and KnowMan MCP.

## Use the hosted remote server instead

Antigravity also supports remote host MCP servers. Remote servers must use the Streamable HTTP transport, set with the `serverUrl` key. The `url` key works as an alias. The legacy HTTP+SSE transport and the `httpUrl` field are not supported. See Antigravity MCP docs.

KnowMan runs a hosted server at `https://api.knowman.io/mcp` over Streamable HTTP. It accepts OAuth sign-in or an API key sent as `Authorization: Bearer <key>`. See KnowMan MCP.

## If something goes wrong

For long-running tools, raise the entry's `timeoutSeconds`. The Antigravity docs show an example that raises a remote server's timeout to 600 seconds, or 10 minutes. See Antigravity MCP docs.

In the App, More actions (⋮) next to a server offers Restart, Disable, or Delete. In the CLI, the MCP Manager Overlay can manually reload server configurations or inspect real-time connection logs. See Antigravity MCP docs.

## The KnowMan tools

Once connected, the server exposes tools documented in the KnowMan MCP repo. `kb_search` finds saved items by [keyword or meaning](https://www.knowman.io/guides/ai-knowledge-base) and returns titles, URLs, and metadata. `kb_ask` answers a question with citations. `kb_get_item` returns the readable content of one item.

`kb_save` saves a URL to the Inbox or the Knowledge Base, with an optional note. `kb_recent` lists recently saved items. `kb_memories` lists saved claims, decisions, and playbooks. For background, see [an MCP server for your knowledge base](https://www.knowman.io/guides/mcp-server-knowledge-base).

## Questions

### Where is Antigravity's MCP config file?

The global file is `~/.gemini/config/mcp_config.json`, which applies to all your projects. A workspace-level file at `<workspace>/.agents/mcp_config.json` applies to one workspace. See Antigravity MCP docs.

### Can Antigravity use KnowMan's hosted MCP server?

Yes, remote host MCP servers are supported and must use the Streamable HTTP transport, set with the `serverUrl` key. KnowMan's hosted server is at `https://api.knowman.io/mcp` and accepts OAuth sign-in or an API key. See Antigravity MCP docs and KnowMan MCP.

### How do I check the server is connected?

In the Antigravity CLI, type `/mcp` in the prompt panel and press Enter to open the MCP Manager Overlay. It shows status rings for active, disconnected, or loading servers, and you can inspect real-time connection logs there. See Antigravity MCP docs.

### Can I connect without pasting an API key?

Run `npx -p @knowman/mcp knowman login` once. It opens a browser sign-in and saves a credential shared by the CLI and the MCP server, so the `env` block can be dropped from the config. See KnowMan MCP.

## Related pages

- [Connect your knowledge base through KnowMan's MCP server](https://www.knowman.io/guides/mcp-server-knowledge-base)

- [What Is a Knowledge Base for AI Agents?](https://www.knowman.io/guides/knowledge-base-for-ai-agents)

- [How Do You Connect AI to Your Notes?](https://www.knowman.io/guides/connect-any-ai-to-your-notes)

- [Give Claude Code a knowledge base built from your reading](https://www.knowman.io/guides/claude-code-knowledge-base)

## More in this topic

- [KnowMan MCP server for GitHub Copilot CLI](https://www.knowman.io/integrations/github-copilot-cli)
- [GitHub Copilot CLI and your knowledge base](https://www.knowman.io/integrations/github-copilot-cli-knowledge-base)
- [KnowMan MCP server for Amazon Q Developer](https://www.knowman.io/integrations/amazon-q-developer)

## More for Google Antigravity

- [How to give Google Antigravity better memory](https://www.knowman.io/guides/antigravity-memory)
- [How to teach Google Antigravity your knowledge](https://www.knowman.io/guides/teach-antigravity-your-knowledge)
- [Google Antigravity and your knowledge base](https://www.knowman.io/guides/antigravity-knowledge-base)

## Bring your library into Antigravity

Try KnowMan Pro for 14 days with no credit card. [Create your account](https://app.knowman.io/signup)

[Start free](https://app.knowman.io/signup)

Every new account starts with 14 days of Pro. No credit card.

Source: https://www.knowman.io/integrations/antigravity