
Knowman Mcp
io.github.EssattPublished by GitHub account Essattv0.3.0Updated Nov 11, 2026
KnowMan MCP server: search, ask, save and read your Knowledge Base from any MCP client.
Overview
Connects an assistant to a KnowMan knowledge base so it can search, read, save and recall saved items and memories.
- What you can do
- Retrieve ranked passages and memories across the whole library in one call, or ask a question with citations
- Read one item's content and metadata, and list recently saved items
- Save a URL to the Inbox or Knowledge Base, optionally with a note and an internal/external trust mark
- List saved memories such as claims, decisions and playbooks (read-only)
- Search saved items without bodies, with location and scope filters (local package only)
- When to use it
- Useful when you keep research, articles and your own documents in KnowMan and want an assistant to answer from that library, cite items, or add new links while working. The hosted endpoint suits clients that only accept remote MCP servers.
- Requirements
- Either the remote endpoint or the local npm package run with npx, which needs Node.js 22 or newer. A KnowMan account and credentials: an API key in KNOWMAN_API_KEY for the local package, or an Authorization Bearer header for the remote server; clients supporting MCP OAuth can sign in through the browser instead. The CLI can also store a credential via knowman login.
Installation
In SourceWeft
- Open Knowman Mcp in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.Essatt%2Fknowman-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"mcpServers": {
"knowman": {
"type": "http",
"url": "https://api.knowman.io/mcp"
}
}
}README
@knowman/mcp
A stdio MCP server that lets an MCP client search, ask, save and read items in a KnowMan account.
Tools
Hosted server (remote)
Local stdio package
Install
npx -y @knowman/mcp runs the server on demand. npm install -g @knowman/mcp installs the knowman-mcp command.
Requires Node.js 22 or newer.
Get a key
Sign in at https://app.knowman.io, create an API key in settings, and set it as KNOWMAN_API_KEY. Never commit the key.
Configuration
Claude Desktop (claude_desktop_config.json):
Claude Code:
Cursor (~/.cursor/mcp.json, or .cursor/mcp.json in a project): use the same mcpServers JSON as the Claude Desktop example above.
Prefer signing in with the browser instead of pasting a key? Install the package globally (npm install -g @knowman/mcp) and run knowman login. The saved credential is shared with knowman-mcp, so the env block is not needed. Run knowman status to check it.
The package runs on your own machine over stdio. KnowMan also runs a hosted server at the endpoint in the next section, for clients that only accept remote MCP servers, such as claude.ai custom connectors.
Remote (hosted) server
Endpoint: https://api.knowman.io/mcp (Streamable HTTP, stateless, JSON responses, MCP protocol 2025-11-25). It exposes four tools: kb_research, kb_get_item, kb_recent and kb_save (see Tools above).
claude.ai. Open Settings, then Connectors, then Add custom connector, and enter https://api.knowman.io/mcp. Sign in with your KnowMan account when the browser opens.
Sign in with OAuth. The server implements OAuth 2.1 for MCP: protected resource metadata at /.well-known/oauth-protected-resource/mcp, authorization server metadata at /.well-known/oauth-authorization-server, dynamic client registration, authorization code with PKCE (S256), and rotating refresh tokens. A client that supports MCP OAuth connects from the endpoint URL alone: it opens a consent page at app.knowman.io, you sign in and approve, and the client receives a one-hour access token plus a refresh token. Access is limited to two scopes: knowman.read (search and read) and knowman.write (save links).
Or use an API key. Create a key in your KnowMan settings and send it as Authorization: Bearer <key>:
Claude Code: claude mcp add --transport http knowman https://api.knowman.io/mcp --header "Authorization: Bearer <your-key>".
What has been verified. The official MCP TypeScript SDK client completes the whole OAuth flow against the live server (registration, consent, token, tool calls, refresh). We have not yet tested ChatGPT connectors or Cursor ourselves; the endpoint follows the requirements those products document, and the redirect URIs they use are allowed. If one of them fails to connect, please open an issue with the product and the error you see.
Disconnect an app. Open the API keys list in your KnowMan settings and delete the entry named OAuth: <app name>. Deleting it revokes the connection and its refresh token. Changing your password also revokes every connected app.
Limits. An API key or an OAuth token cannot create other API keys. Requests are rate limited per token and per IP.
CLI reference
Source: README.md at commit 331e04d
Tools
0Version history
1- v0.3.0LatestNov 11, 2026
Score
85% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts

