# Connect KnowMan to Augment Code

Client: Augment Code

Add KnowMan to Augment Code as a local server using MCP settings or JSON import, then [sign in](https://www.knowman.io/guides/personal-knowledge-base) once with `knowman login`. KnowMan’s [local stdio server](https://www.knowman.io/guides/what-is-an-mcp-server) provides six tools for working with [saved items](https://www.knowman.io/guides/how-to-save-articles) and memories. [Augment documents local MCP configuration](https://docs.augmentcode.com/setup-augment/mcp), and [KnowMan documents its MCP server]( /guides/mcp-server-knowledge-base).

## Augment Code JSON import

```json
{
  "mcpServers": {
    "knowman": {
      "command": "npx",
      "args": ["-y", "@knowman/mcp"]
    }
  }
}
```

## Add the KnowMan server configuration

In Augment’s options menu, open Settings, then use Import from JSON in the MCP section. Paste the configuration below and select Save. [Augment documents JSON import for local MCP servers](https://docs.augmentcode.com/setup-augment/mcp).

KnowMan’s MCP server runs locally over stdio with `npx -y @knowman/mcp` and requires Node 22 or newer. [Read about the KnowMan MCP server](https://www.knowman.io/guides/mcp-server-knowledge-base).

## Sign in once with knowman login

In a terminal on the same machine, run `npx -p @knowman/mcp knowman login` and complete browser sign-in. The CLI and MCP server share the saved credential, so you can omit an environment block. [Read about KnowMan MCP sign-in](https://www.knowman.io/guides/mcp-server-knowledge-base).

You can also create an agent key in KnowMan under Settings > Connections > Connect an AI agent, then provide `KNOWMAN_API_KEY` to the server through its environment. [Read about KnowMan MCP credentials](https://www.knowman.io/guides/mcp-server-knowledge-base).

## Verify the connection

After importing, find KnowMan in Augment’s MCP server list and use its test action. Augment says imported servers can be edited, tested, or removed from that list. [Augment documents the server list and test action](https://docs.augmentcode.com/setup-augment/mcp).

The exact success message or status indicator is not documented. KnowMan’s server provides six tools when connected. [See the KnowMan MCP tools](https://www.knowman.io/guides/mcp-server-knowledge-base).

## What the six KnowMan tools do

`kb_search` searches saved items by [keyword or meaning](https://www.knowman.io/guides/ai-knowledge-base). `kb_ask` answers questions with citations. [See the KnowMan MCP tool descriptions](https://www.knowman.io/guides/mcp-server-knowledge-base).

`kb_get_item` reads one item, `kb_save` saves a URL with an optional note, and `kb_recent` lists recent items. `kb_memories` lists saved claims, decisions, and playbooks. [See the KnowMan MCP tool descriptions](https://www.knowman.io/guides/mcp-server-knowledge-base).

## Use Augment’s settings for later changes

Servers added through Settings or JSON import are managed in the same Augment Settings Panel location. You can edit, test, or remove an imported server there. [Augment documents server management](https://docs.augmentcode.com/setup-augment/mcp).

Augment’s local-server form has separate name, command, and environment-variable fields. The name must uniquely identify the server, and environment variables do not need to be embedded in the command. [Augment documents the local-server fields](https://docs.augmentcode.com/setup-augment/mcp).

## Common setup checks

Make sure required server dependencies are installed locally. KnowMan requires Node 22 or newer to run its package. [Augment documents local dependencies](https://docs.augmentcode.com/setup-augment/mcp) and [KnowMan documents its Node requirement](https://www.knowman.io/guides/mcp-server-knowledge-base).

Augment notes that not every MCP server is compatible with its models, so check compatibility if the server test does not work. [Read Augment’s MCP setup guidance](https://docs.augmentcode.com/setup-augment/mcp).

## Questions

### Does KnowMan run locally or remotely in Augment Code?

KnowMan’s MCP server is a local stdio process started with `npx -y @knowman/mcp`. It connects to KnowMan’s HTTP API using a saved credential or `KNOWMAN_API_KEY`. [Read about the KnowMan MCP server](https://www.knowman.io/guides/mcp-server-knowledge-base).

### Do I need to restart Augment after adding KnowMan?

Augment’s setup documentation says the change takes effect immediately and no restart is required. You can test the imported server from the server list. [Read Augment’s MCP setup guidance](https://docs.augmentcode.com/setup-augment/mcp).

### Can I sign in without putting an API key in the config?

Yes. Run `npx -p @knowman/mcp knowman login` once and complete browser sign-in. The MCP server shares the CLI’s saved credential, so an environment block can be omitted. [Read about KnowMan MCP sign-in](https://www.knowman.io/guides/mcp-server-knowledge-base).

### Which tools does KnowMan add to Augment?

KnowMan provides `kb_search`, `kb_ask`, `kb_get_item`, `kb_save`, `kb_recent`, and `kb_memories`. They search saved items, answer with citations, read or save items, list recent items, and list saved memories. [See the KnowMan MCP tool descriptions](https://www.knowman.io/guides/mcp-server-knowledge-base).

## Related pages

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

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

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

## More in this topic

- [Connect KnowMan to JetBrains AI Assistant](https://www.knowman.io/integrations/jetbrains)
- [KnowMan MCP server for Kilo Code](https://www.knowman.io/integrations/kilo-code)
- [Connect KnowMan to Kiro](https://www.knowman.io/integrations/kiro)

## More for Augment Code

- [How to give Augment Code better memory](https://www.knowman.io/guides/augment-memory)
- [How to teach Augment Code your knowledge](https://www.knowman.io/guides/teach-augment-your-knowledge)

## Give Augment your saved knowledge

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/augment