# KnowMan MCP server for Jan

Client: Jan

To add the KnowMan MCP server to Jan, open Settings → MCP Servers, click the + sign, and enter Command npx with Arguments -y @knowman/mcp and your KnowMan API key as the [environment variable](https://www.knowman.io/guides/mcp-server-knowledge-base) ([Jan docs](https://docs.jan.ai/desktop/mcp)). The server is the npm package @knowman/mcp, which runs locally over stdio and exposes six tools for your KnowMan library ([npm](https://www.npmjs.com/package/@knowman/mcp)).

## New server form in Jan, Settings → MCP Servers

```text
Server Name: knowman
Command: npx
Arguments: -y @knowman/mcp
Environment Variables: KNOWMAN_API_KEY=km_...
```

## What you need first

Jan supports the [Model Context Protocol](https://www.knowman.io/guides/what-is-an-mcp-server) (MCP), an open standard for letting language models interact with external tools and data sources, and works as an MCP host (Jan docs). For background, see the [KnowMan MCP server guide](https://www.knowman.io/guides/mcp-server-knowledge-base).

You need three things. Node.js installed on your machine, because Jan requires NodeJS and/or Python for MCP servers (Jan docs), and the KnowMan package needs Node 22 or newer (npm). A KnowMan account at [app.knowman.io](https://app.knowman.io). And a KnowMan API key, or the one-time browser sign-in described below.

## Create a KnowMan API key

Open app.knowman.io and go to Settings > Connections > Connect an AI agent. Create a key there. Keys look like km_... ([GitHub](https://github.com/Essatt/knowman-mcp)).

## Add the server in Jan

MCP servers in Jan are configured under Settings → MCP Servers (Jan docs). Click the + [sign in](https://www.knowman.io/guides/personal-knowledge-base) the upper right-hand corner of the MCP box, then fill in the form with the values shown above (Jan docs). A server entry consists of Server Name, Command, Arguments, and Environment Variables fields (Jan docs).

Jan's documented setup runs local servers through a command, such as npx with a package argument (Jan docs). @knowman/mcp is KnowMan's stdio server package, and KNOWMAN_API_KEY is the environment variable it reads (npm).

## Or sign in once with knowman login

If you would rather not paste a key into the form, run `npx -p @knowman/mcp knowman login` once in a terminal. It opens your browser for sign-in and saves the credential (npm).

The saved credential is shared by the CLI and the MCP server, so you can leave the Environment Variables field empty (npm).

## Check that it works

After saving the entry, check that the server has been activated successfully (Jan docs). Then ask Jan to use it, for example "search my KnowMan for ..." or "save this URL" (GitHub).

By default you must approve each tool call individually, and approval panels appear inline in the chat, showing the exact arguments before you accept or deny (Jan docs). To pre-approve everything, enable Allow All MCP Tool Permission in Settings (Jan docs).

## The six KnowMan tools

The server exposes six tools (npm). `kb_search` searches [saved items](https://www.knowman.io/guides/how-to-save-articles) by [keyword or meaning](https://www.knowman.io/guides/ai-knowledge-base) and returns titles, URLs and metadata. `kb_ask` answers questions 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 recent items. `kb_memories` lists saved claims, decisions and playbooks.

## Pick a model that can call tools

The model you use must have tools enabled for MCP to work (Jan docs). For local models, enable tool calling in the model parameters with the edit button in Model Capabilities (Jan docs).

Not all downloadable models are good at tool calling or compatible with MCP, and many open-source models are not designed for tool use, so you may need to try a different model (Jan docs). Jan's docs recommend a model with strong tool-use capabilities, such as Claude Sonnet or Opus (Jan docs). If you enter an Anthropic API key under Model Providers > Anthropic, Jan lists the available Anthropic models automatically (Jan docs).

## Troubleshooting and cautions

If the server will not connect, make sure you typed the commands correctly in the MCP Server form, restart Jan, and make sure the model you are using has tools enabled (Jan docs). If the key might be wrong, create a new one under Settings > Connections > Connect an AI agent in the KnowMan web app (GitHub).

Two cautions from Jan's docs. Active MCP connections may consume part of a model's context window, which could affect performance. Granting a model access to external tools is a significant security consideration, including prompt injection risks (Jan docs).

## Questions

### How do I add an MCP server to Jan?

Open Settings → MCP Servers and click the + sign in the upper right-hand corner of the MCP box. Enter the Server Name, Command, Arguments, and Environment Variables for the server (Jan docs). For KnowMan, use npx and -y @knowman/mcp (npm).

### Does Jan need Node.js for the KnowMan MCP server?

Yes. Jan requires NodeJS and/or Python installed on your machine to use MCP servers (Jan docs). The KnowMan package @knowman/mcp needs Node 22 or newer (npm).

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

Yes. Run `npx -p @knowman/mcp knowman login` once, which opens a browser sign-in. The saved credential is shared by the CLI and the MCP server, so the environment variable can be dropped (npm).

### Why does my Jan MCP server not connect?

Make sure you typed the commands correctly in the MCP Server form, restart Jan, and check that your model has tools enabled (Jan docs). Also check that the server has been activated successfully after you add it (Jan docs).

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

- [What is a personal knowledge base, and how do you build one?](https://www.knowman.io/guides/personal-knowledge-base)

## More in this topic

- [KnowMan MCP server for Microsoft Copilot Studio](https://www.knowman.io/integrations/copilot-studio)
- [Add the KnowMan MCP server to LM Studio](https://www.knowman.io/integrations/lm-studio)
- [Add the KnowMan MCP server to LibreChat](https://www.knowman.io/integrations/librechat)

## More for Jan

- [How to give Jan better memory](https://www.knowman.io/guides/jan-memory)
- [How to teach Jan your knowledge](https://www.knowman.io/guides/teach-jan-your-knowledge)
- [Jan and your personal knowledge base](https://www.knowman.io/guides/jan-knowledge-base)

## Give Jan your reading library

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