Esa MCP Server

Official MCP server for esa.io - a documentation sharing service for teams. It runs locally over stdio via the published package.

People connecting documentation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-20 · ★ 62 · #10 OF 183 MAINTAINED DOCUMENTATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Esa

before you install - you'll need

ESA_ACCESS_TOKEN

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add esaio-esa-mcp-server -- npx -y @esaio/esa-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "esaio-esa-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@esaio/esa-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · container (OCI image) - can be sandboxed away from your filesystem

license MIT - declared in the repository

npm package @esaio/esa-mcp-server - published under the repo owner's npm scope (@esaio)

registry namespace io.github.esaio is GitHub-verified and matches the repo owner

03 · What Esa can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.13.0 · 2026-06-23

記事本文への追記ツール esa_append_post / esa_prepend_post を追加 · Update dependencies

v0.12.0 · 2026-06-07

esa_rollback_post_revision を追加 · esa_get_post で body_md の文字数・行数を body_md_stats として返す · Bump tsx from 4.22.3 to 4.22.4

v0.11.0 · 2026-05-28

Bump i18next from 26.2.0 to 26.3.0 · Bump @biomejs/biome from 2.4.15 to 2.4.16 · esa_get_post に truncate オプションを追加 · Bump tsdown from 0.22.0 to 0.22.1

04 · Who maintains Esa

esa is maintained by esaio. We track 2 MCP servers from esaio - 2 actively maintained, 62 combined GitHub stars, oldest repo from Sep 2025.

05 · Facts

category
documentation - ranked #10 of 183 actively-maintained documentation servers as of 2026-08-25.
release cadence
3 releases in the last 90 days (latest 2026-06-23)
registry
io.github.esaio/esa (active, first published 2026-03-08 · 17 versions)
packages
npm:@esaio/esa-mcp-server · oci:ghcr.io/esaio/esa-mcp-server:0.13.0

06 · Esa FAQ

What is Esa?

Official MCP server for esa.io - a documentation sharing service for teams. It runs locally over stdio via the published package.

Is Esa still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-20 and it shipped 3 releases in the last 90 days. We re-verify nightly.

How do I install Esa?

Run `npx -y @esaio/esa-mcp-server`. The README documents one environment variable (ESA_ACCESS_TOKEN) to set first. You can also paste the ready-made client config above.

Does Esa run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Esa