# DocsMint (MCP server)

> DocsMint is an MCP server that adds search and knowledge tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Cloud or self-hosted knowledge for AI agents: hybrid search, reranking, GraphRAG, scoped MCP tools. It has 118 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @hiai-gg/docsmint.

Give your AI agents persistent project knowledge. Search, read, create, and organize documents with hybrid retrieval, reranking, GraphRAG, and scoped access.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/HiAi-gg/docsmint |
| GitHub stars | 118 |
| License | Apache-2.0 |
| Language | TypeScript |
| Transport | stdio, streamable-http |
| Packages | npm: @hiai-gg/docsmint |
| Remote URL | https://docsmint.com/mcp |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code, Claude.ai, ChatGPT |
| Category | AI & search |
| Latest release | v1.0.2 (Sep 28, 2026) |
| Last commit | Sep 28, 2026 |
| MCP registry name | io.github.HiAi-gg/docsmint |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "docsmint": {
      "command": "npx",
      "args": [
        "-y",
        "@hiai-gg/docsmint"
      ],
      "env": {
        "HIAI_DOCS_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env HIAI_DOCS_API_KEY=your-value --transport stdio docsmint -- npx -y @hiai-gg/docsmint
```

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

```json
{
  "mcpServers": {
    "docsmint": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hiai-gg/docsmint"
      ],
      "env": {
        "HIAI_DOCS_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

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

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "hiai_docs_api_key",
      "description": "HIAI_DOCS_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "docsmint": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hiai-gg/docsmint"
      ],
      "env": {
        "HIAI_DOCS_API_KEY": "${input:hiai_docs_api_key}"
      }
    }
  }
}
```

### Claude Code (remote)

```sh
claude mcp add --transport http docsmint "https://docsmint.com/mcp"
```

The same server is also hosted as a remote MCP endpoint, so nothing runs on your machine.

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `HIAI_DOCS_URL`: Base URL of your running self-hosted DocsMint REST API, for example http://localhost:50700. For Cloud MCP, use the Streamable HTTP remote below.
- `HIAI_DOCS_API_KEY` (secret) (required): Create an API key in your self-hosted DocsMint browser UI. The stdio bridge uses it only with your own API; it does not install the Cloud OAuth server. Prefer…

## Tools

- `find_documents`: Browse by folder/tag UUID with mode=list, or hybrid-search by text/tag names with mode=search.
- `read_document`: Read content and metadata with view=detail, export Markdown with view=markdown, or list revisions and snapshots with…
- `save_document`: Create a document with action=create or patch an existing one with action=update.
- `delete_document`: Move a document to trash without purging its content or versions.
- `list_workspace_structure`: List folders, categories, or tags with kind=folders|categories|tags; folders optionally accept parentId.
- `save_folder`: Create with action=create or rename, move, or reorder with action=update; metadata changes queue reindexing.
- `delete_folder`: Remove a folder while preserving its documents under the API's detachment rules.
- `save_category`: Create with action=create or rename/reorder with action=update; requires full workspace write access.
- `delete_category`: Remove a category and detach its documents; requires full workspace write access.
- `save_tag`: Create with action=create or rename/recolor with action=update; requires full workspace write access.
- `delete_tag`: Delete a tag and its assignments without deleting documents.
- `set_document_tag`: Assign with action=add or unassign with action=remove; requires edit access to the document.
- `create_snapshot`: Save a named version of the current document content.
- `restore_document_version`: Restore content from a revision or snapshot selected through readdocument(view=versions); pass that document's UUID as…
- `explore_graph`: Traverse one document with mode=neighbors or rank relations from seed IDs with mode=search.
- `get_document_index_status`: Inspect indexing state without starting work.
- `refresh_document_index`: Queue an explicit asynchronous retry after checking status.
- `list_trash`: List soft-deleted documents visible in the active scope.
- `restore_trashed_document`: Recover a soft-deleted document; this does not restore an older version.
- `permanently_delete_document`: Irreversibly purge a document already in trash on explicit user request.
- `batch_documents`: Apply one action to 1–25 explicit document IDs: move, set category, add/remove one tag, trash, restore, or refresh…
- `get_workspace_item`: Read one visible folder, category, or tag by UUID. Categories and tags are selected from the complete…

## Similar MCP servers

- [Context7](https://appsgit.com/mcp-servers/context7): Up-to-date code docs for any prompt. (62,752 stars, MIT, needs API key)
- [FunASR](https://appsgit.com/mcp-servers/funasr): Transcribe local audio with FunASR and SenseVoice using private, on-device inference. (20,596 stars, MIT)
- [Bifrost](https://appsgit.com/mcp-servers/bifrost): Fastest enterprise AI gateway (50x faster than LiteLLM) with adaptive load balancer, cluster mode, guardrails, 1000+ models support & <100 µs overhead at 5k RPS. (8,591 stars, Apache-2.0)
- [Honcho](https://appsgit.com/mcp-servers/honcho): Memory that reasons: continual learning for stateful agents. (7,494 stars, AGPL-3.0, needs API key)
- [Semble](https://appsgit.com/mcp-servers/semble): Fast and Accurate Code Search for Agents. (6,185 stars, MIT)
- [Exa](https://appsgit.com/mcp-servers/exa): Connect AI agents to Exa for web search, content fetching, and multi-step research. (5,088 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/docsmint
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.