OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
MCP & Tooling

Docsagent

DocsAgent is an MCP server with a TypeScript shell and resident C++ search engine that connects compatible AI clients to Zotero libraries, Obsidian vaults and macOS Apple Notes. It supports local BM25 search, query-ranked passage retrieval, reading and writing across configured sources.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Docsagent — OpenViST project profile in MCP & Tooling.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use DocsAgent when an MCP-compatible client needs to search or work with a personal library across Zotero, Obsidian and, on macOS, Apple Notes.

Who it is for

  • People who want an MCP-compatible AI client to search a personal Zotero library or Obsidian vault.
  • macOS users who also want to include Apple Notes.
  • Developers setting up local knowledge retrieval for a compatible MCP client.

Documented uses

  • Search Zotero items, annotations and notes, or search an Obsidian vault.
  • Retrieve ranked passages and snippets from indexed sources.
  • Connect supported sources to a single mixed search.
  • Use MCP tools to read and, when enabled, write supported knowledge sources.
Before you choose

Requirements & limits

The repository documents npm and Python distribution paths. The Python package instructions build from the repository. The bundled core is documented for macOS, Windows x64 and Linux x64; Linux ARM is not supported. Apple Notes is macOS-only.

  • The core is a separate resident service and must be started before the MCP shell connects.
  • Writes are disabled by default and require configuration to register the write tools.
  • The package offers stdio for local MCP clients and Streamable HTTP with authentication and RBAC options for remote deployment.
  • The MCP shell is TypeScript, with a feature-equal Python wrapper documented against the same tools and JSON-RPC contract.
  • The repository is public, but no license is specified in its license field.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Start the core and connect an MCP client

Set up the DocsAgent core and configure a compatible MCP client to connect through the documented stdio shell.

Before you start

  • The DocsAgent repository and its bundled core for the platform.
  • An MCP-compatible client such as Claude Desktop, Cursor, Cline or Qwen Code.
  • A supported source configured for indexing.

Steps

  1. Run the command below to start the core.

    Documented command
    npx @docsagent/docsagent start

  2. Add the documented docsagent server entry to the client's mcpServers configuration, using npx and @docsagent/docsagent.

  3. Start the MCP shell through the client; it connects to the running core and checks source and index status.

Expected outcome

The MCP client is configured to connect to the DocsAgent core and access its available tools.

Guide limitations

  • The core must be running before the shell starts; the shell does not spawn it.
  • Apple Notes is available only on macOS.
  • The guide covers connection setup, not a particular search or write workflow.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
16 October 2026
Original website title
docsagent/docsagent · Official homepage title · retained in its source language
How we review sourcesSuggest a correction