# DocsMint

> DocsMint is a freemium MCP server for knowledge and memory. Persistent document knowledge for agents with hybrid search, reranking and GraphRAG. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, CLI, self-hosted
- **Website:** https://docsmint.com/mcp/connect
- **Repository:** https://github.com/hiai-gg/docsmint/tree/HEAD/packages/mcp-server
- **MCP Registry name:** io.github.HiAi-gg/docsmint
- **Categories:** knowledge and memory, files and documents
- **Listing updated:** 2026-11-14

## About

DocsMint is a document workspace, and this server lets agents search, read, create, organise and update what is in it. Access is scoped: OAuth consent binds a token to a chosen workspace, an optional category and the mcp:read, mcp:edit and mcp:write scopes. Hosted tokens expire after one hour and no refresh tokens are issued, so you authorise again afterwards. API-key clients can instead send a Bearer key, preferably bound to a workspace or category.

There are two routes. DocsMint Cloud is recommended, using the hosted endpoint at docsmint.com/mcp with no server of your own. The self-hosted route runs the open-source DocsMint stack and connects a stdio bridge from the @hiai-gg/docsmint package to your own API, using HIAI_DOCS_URL and an API key.

Hosted MCP is metered: the free personal workspace includes 200 calls a month with up to 10 document creates or updates, and the paid plans raise this (3,000 calls a month on Pro).

## Features

- **Hybrid retrieval:** Combines search with reranking and GraphRAG over your documents.
- **Scoped access:** Consent binds tokens to a workspace, optional category and read, edit or write scope.
- **Document editing:** Agents can create, organise and update documents, not just read.
- **Hosted or self-hosted:** Cloud endpoint at docsmint.com/mcp, or a stdio bridge to your own deployment.
- **Revocable credentials:** Tokens expire after an hour and can be revoked in the browser UI.
- **Usage budget:** Hosted MCP calls are counted per plan or shared workspace budget.

## Good for

- Give a coding agent persistent project notes it can search
- Let an assistant draft and update documents in a scoped workspace
- Query self-hosted internal docs from Claude Code
- Restrict an agent to one category of documents

## Install

### Claude Code (Terminal)

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

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

```sh
https://docsmint.com/mcp
```

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

```json
{
  "mcpServers": {
    "docsmint": {
      "url": "https://docsmint.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "docsmint": {
      "type": "http",
      "url": "https://docsmint.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "docsmint": {
      "serverUrl": "https://docsmint.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "docsmint": {
      "type": "http",
      "url": "https://docsmint.com/mcp"
    }
  }
}
```

## FAQ

### Is there a free tier?

Yes. A free personal workspace includes 200 hosted MCP calls a month, including up to 10 document creates or updates.

### Can I self-host?

Yes. Run DocsMint OSS and connect the docsmint-mcp stdio bridge with HIAI_DOCS_URL and HIAI_DOCS_API_KEY.

### How does OAuth work?

Authorization code with PKCE S256, bound to the hosted MCP resource; tokens last one hour with no refresh.

### Which clients can connect?

Any client that supports Streamable HTTP with OAuth or a Bearer key; the README shows Codex as an example.

### Is DocsMint free?

DocsMint has a free plan, with paid plans for more usage or features.

### How do I add DocsMint to Claude Code?

Run this command in your terminal: claude mcp add --transport http docsmint https://docsmint.com/mcp

### What are the best alternatives to DocsMint?

The closest alternatives to DocsMint are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## 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.
- [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.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.

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