# Knowman MCP

> Knowman MCP is an MCP server for knowledge and memory. Search, read and save to your KnowMan knowledge base from any MCP client. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI, Web
- **Website:** https://knowman.io
- **Repository:** https://github.com/essatt/knowman-mcp
- **MCP Registry name:** io.github.Essatt/knowman-mcp
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-14

## About

KnowMan is a read-later knowledge base: you save articles, newsletters and feeds, and it reads them in full, organizes them and keeps the source. This server gives Claude, Codex, Cursor or your own agents the same library, including the decisions and playbooks you have recorded, so they start from your reasoning instead of a fresh briefing.

The hosted endpoint exposes four tools: kb_research returns ranked passages and memories across the whole library in one call and leaves the answer to the assistant, kb_get_item reads one item, kb_recent lists recent saves and kb_save adds a URL to Inbox or Knowledge Base. The local npm package, which needs Node.js 22 or newer, also carries older kb_search, kb_ask and kb_memories tools that the README marks deprecated.

Hosted access uses OAuth 2.1 with two scopes, knowman.read and knowman.write, or an API key as a Bearer token. The stdio package takes a KNOWMAN_API_KEY or a browser login. Team plans are listed as not available yet.

## Features

- **One-call research:** kb_research returns ranked passages and memories across the library.
- **Read single items:** Fetch content and metadata for one saved item.
- **Save links:** Add a URL to the Inbox or the Knowledge Base.
- **Decisions and playbooks:** Agents can read the decisions and playbooks you recorded.
- **Scoped OAuth:** Read and write access are separate scopes.
- **Remote or local:** Use the hosted endpoint or the stdio npm package.

## Good for

- Ask Claude what you decided about pricing and why
- Have an agent follow a playbook you wrote once
- Save an article link to your library from a chat
- List what you saved recently
- Reduce repeated briefing across several agents

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http knowman-mcp https://api.knowman.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.knowman.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "knowman-mcp": {
      "url": "https://api.knowman.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "knowman-mcp": {
      "type": "http",
      "url": "https://api.knowman.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "knowman-mcp": {
      "serverUrl": "https://api.knowman.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "knowman-mcp": {
      "type": "http",
      "url": "https://api.knowman.io/mcp"
    }
  }
}
```

## Tools

- `kb_research`: Retrieve ranked passages and memories across the whole library.
- `kb_get_item`: Read content and metadata for one item.
- `kb_recent`: List recently saved items.
- `kb_save`: Save a URL to Inbox or Knowledge Base.
- `kb_search`: Search saved items without bodies (deprecated).
- `kb_ask`: Ask a question over the whole library (deprecated).
- `kb_memories`: List saved claims, decisions and playbooks (deprecated).

## FAQ

### How do I connect it?

Add https://api.knowman.io/mcp as a custom connector and sign in with OAuth, or run npx -y @knowman/mcp with KNOWMAN_API_KEY set.

### Which tools does the hosted server have?

kb_research, kb_get_item, kb_recent and kb_save.

### Is there a trial?

The site says every new account starts with 14 days of Pro, no credit card.

### What does it need locally?

The stdio package needs Node.js 22 or newer.

### Is Knowman MCP free?

Knowman MCP is a paid product with a free trial.

### How do I add Knowman MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http knowman-mcp https://api.knowman.io/mcp

### What are the best alternatives to Knowman MCP?

The closest alternatives to Knowman MCP are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/knowman-mcp
