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.
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.
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.
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.
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.
The exact success message or status indicator is not documented. KnowMan’s server provides six tools when connected. See the KnowMan MCP tools.
What the six KnowMan tools do
kb_search searches saved items by keyword or meaning. kb_ask answers questions with citations. See the KnowMan MCP tool descriptions.
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.
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.
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.
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 and KnowMan documents its Node requirement.
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.
Questions people ask
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.
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.
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.
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.