Skip to content
appsgit

DocsMint

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.

github.com/HiAi-gg/docsmint (opens in a new tab)

Install DocsMint

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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

Cursor

.cursor/mcp.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
{
  "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)

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 Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
HIAI_DOCS_URLNoBase 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_KEYsecretYesCreate 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 (22)

Parsed from the Tools section of the README; check the repository for the current list.

  • 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…

About DocsMint

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

  • ai-agents
  • graphrag
  • knowledge-management
  • mcp
  • pwa
  • knowledge-base
  • markdown
  • open-source
  • rag
  • self-hosted

FAQ

DocsMint FAQ

Still curious? Email info@appsgit.com.

What is DocsMint?

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. The source code is at github.com/HiAi-gg/docsmint.

How do I install the DocsMint MCP server?

Add the command npx -y @hiai-gg/docsmint to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is DocsMint free?

The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (HIAI_DOCS_API_KEY) for the service it connects to, which may require a paid account.

Is DocsMint actively maintained?

The most recent commit was on Sep 28, 2026. The latest release is v1.0.2, published Sep 28, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.