StashBase logo

StashBase

Connects MCP clients to a selected local StashBase project for reading, searching, and editing supported files.

Install StashBase

Pick your client, then add it in one click or paste the config.

No confirmed install command yet

We only publish a config when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for StashBase, and we’d rather show nothing than a guess you’d paste into your client.

Open setup steps on GitHub

Overview

StashBase MCP server exposes a selected local StashBase project to external MCP clients. Agents can read supported files, search project content, and edit files while StashBase remains running. It fits writing and research workflows where project files should remain on the user’s computer.

Use cases

  • Read local notes while drafting with an external agent
  • Edit workspace documents through an MCP-compatible client
  • Review agent changes in StashBase’s document editor

Key features

  • Reads supported files from a selected local project
  • Searches project content
  • Edits supported project files
  • Works with notes, PDFs, Word documents, and scans
  • Shares projects with built-in and external agents
  • Uses locally processed document extraction and OCR

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

26/26 checks healthy over the last 17d

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1.3kStargazers on the source repository.
Last commit1d agoMost recent push to the default branch.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How StashBase works

What StashBase does

StashBase provides a local workspace for writing with AI agents and exposes the active project through MCP. External MCP clients can access supported files in the selected project without requiring those files to be moved into a hosted knowledge base.

The MCP connection supports three core operations: reading files, searching project content, and editing files. StashBase’s built-in Chat connects to these tools automatically; external clients use the MCP configuration shown in the application.

How it works

Open or create a local project in StashBase, then keep the application running while an external MCP client connects. In StashBase, open Settings → Advanced → External apps (MCP) and copy the connection configuration into the client. The configuration includes the connection details and access settings needed for the client to work with the selected project.

The Documents area provides a file tree and editor for the same project used by Chat and MCP access. Agents can therefore search or edit files while the user reviews the results in StashBase. Supported document processing, including PDF and Word text extraction and OCR, runs locally; required components are downloaded on first use.

Setup and configuration

Install StashBase on macOS 12 or later, Windows 10 or later, or a community-supported Linux x86_64 system running Debian 12 or Ubuntu 22.04 or later. macOS packages are available through Homebrew or the latest release downloads. Windows and Linux packages are also provided through the release downloads.

After launching the application:

  1. Open or create a project folder.
  2. Select the project that the external client should access.
  3. Open Settings → Advanced → External apps (MCP).
  4. Copy the displayed configuration into the MCP client.
  5. Keep StashBase running while the client uses the connection.

Tools and capabilities

  • Read supported files from the selected local project.
  • Edit supported files through an external MCP client.
  • Work with notes, PDFs, Word documents, and scans processed in the local workspace.
  • Share the same project between StashBase Chat, the Documents editor, and external agents.

Limitations and notes

MCP access is tied to the project selected in the running StashBase application. Removing a project from StashBase does not delete its files, but the files remain under the user’s local filesystem management.

The MCP client must use the connection configuration supplied by StashBase, and the application needs to remain open. File support depends on the formats StashBase can process. On Intel Macs, local search and PDF or image text extraction require macOS 15 or later; older supported systems can still open projects and edit files.

Agent conversations may send prompts and relevant context to model services, depending on the agent being used. Usage statistics and error diagnostics are enabled by default for packaged builds and source runs, excluding document and conversation content; this can be disabled in Settings → General → Privacy.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about StashBase

StashBase is an MCP server that connects external MCP clients to a selected local StashBase project. Its main tools let agents read supported files, search project content, and edit files. StashBase must remain running, and access is configured from Settings → Advanced → External apps (MCP).

Install the StashBase desktop application, then configure MCP from its settings. Packages are available for macOS, Windows, and supported Linux systems. After opening a project, copy the connection configuration from Settings → Advanced → External apps (MCP) into your external client.

Copy the MCP configuration from StashBase’s External apps (MCP) settings into the client. Select the project the client should access first, and keep StashBase running during the connection. The client can then read, search, and edit supported files in that project.

Yes, external MCP clients can edit supported files in the selected StashBase project. They can also read files and search project content. The resulting documents remain in the local project folder and can be reviewed in StashBase’s Documents editor.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewStashBase AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/stashbase-2?style=directory)](https://allmcps.com/mcp/stashbase-2)
HTML Embed
<a href="https://allmcps.com/mcp/stashbase-2"><img src="https://allmcps.com/api/badge/stashbase-2?style=directory" alt="StashBase on AllMCPs" /></a>