Log inSubmit server
Esa logo

Esa

Connects AI assistants to esa.io for searching, reading, creating, updating, and managing team documentation.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Esa

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

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "esa": {
      "command": "npx",
      "args": [
        "-y",
        "@esaio/esa-mcp-server"
      ],
      "env": {
        "ESA_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "LANG": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 22 tools correctly (3d ago).

Overview

The esa MCP server connects AI assistants to esa.io through the Model Context Protocol over STDIO. It exposes tools for team information, article and comment management, categories, attachments, search help, and Markdown help, plus a recent-posts resource and article-summary prompt. Reach for it when an assistant needs to find, maintain, organize, or summarize documentation stored in esa.

Use cases

  • Search team documentation from an AI assistant
  • Create and update esa articles with metadata
  • Review backlinks, comments, tags, and categories
  • Summarize a selected esa article
  • Retrieve recent posts and attachments

Key features

  • Team, member, tag, and statistics queries
  • Post search, creation, editing, publishing, and duplication
  • Comment creation, editing, deletion, and listing
  • Category path browsing with filtering
  • Attachment retrieval with base64 or signed URLs
  • Recent-post resource and article-summary prompt

Tools22

What Esa lets your agent do. Expand a tool for its parameters.

Verified live~4.1k tokens of context

Security & health

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

ActiveLast checked 1d ago

Recent health check succeeded.

7/7 checks healthy over the last 39d

What it can do

From the 22 tools this server returned when we ran it.

Can delete or modify data · 1Makes network requests · 1Read-only tools · 21
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age403 days
Maintainers2

Observed 2026-10-24 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · @esaio/esa-mcp-server (npm)

Adoption & maintenance

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

GitHub stars62Stargazers on the source repository.
npm downloads34kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed22Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Esa works

What esa MCP server does

The esa MCP server gives MCP-compatible assistants access to documentation and collaboration data in esa.io. It can inspect teams, members, tags, statistics, categories, articles, comments, and attachments. It also supports changes to esa content, including creating and updating posts, adding or editing comments, archiving posts, publishing WIP posts with Ship It!, and duplicating posts within or across teams.

The server covers both individual records and broader team workflows. Assistants can search posts, inspect backlinks, list comments with pagination, review category paths with article counts, and retrieve recent posts through an MCP resource. The included summarization prompt takes a team and article ID and produces a structured summary.

How it works

Communication uses the Model Context Protocol with the STDIO transport. The assistant invokes named tools that map to esa operations, such as esa_search_posts, esa_get_post, esa_create_post, and esa_update_post. Read and write behavior depends on the permissions granted to the esa access token.

Attachment handling varies by file type and size. JPEG, PNG, GIF, and WebP images up to 30 MB can be returned as base64 data. Other files, larger images, or requests that force signed URLs are returned as signed URLs with a five-minute validity period.

The package also includes registry.json, which lists its tools, resource, and prompt without requiring the server to start. The recent-posts resource uses the URI pattern esa://teams/{teamName}/posts/recent.

Setup and configuration

The esa MCP server requires an ESA_ACCESS_TOKEN. The README recommends a PAT v2 token. The token must have either the broad read write scopes or the documented set of post, comment, category, tag, attachment, team, and member permissions needed by the operations you plan to use. LANG controls the interface language.

For Claude Desktop, configure the server as a STDIO process. The documented options run the published container image with Docker or launch the npm package with npx. In either case, pass ESA_ACCESS_TOKEN and optionally set LANG, such as ja. When using the npx option, configure the path to the Node executable available on your machine.

Tools and capabilities

Available capability groups include:

  • Team discovery: list teams, members, roles, profiles, statistics, and tag usage.
  • Post operations: search, retrieve, create, update, append, prepend, archive, publish, duplicate, and inspect backlinks.
  • Comment operations: retrieve, create, update, delete, and list comments for a post or team.
  • Category operations: list top-level categories, inspect children, or filter all category paths by prefix or matching text.
  • Help and media: search esa help, retrieve search and Markdown syntax guidance, and fetch attachments.

Appending or prepending text creates a new revision without first retrieving the existing article body. Post retrieval can include backlink totals and body character and line counts.

Limitations and notes

The esa MCP server is focused on esa.io and requires a valid access token with suitable scopes. It is distributed as an STDIO server; the provided setup examples specifically document Docker, npx, and Claude Desktop rather than a hosted HTTP endpoint. Signed attachment URLs expire after five minutes, so clients should use them within that period.

Write operations can change shared team content, including deleting comments, archiving posts, publishing WIP posts, and duplicating articles. Configure token permissions and assistant workflows accordingly. The server’s category, comment, and backlink listings support pagination where documented, so clients may need to request additional pages for complete results.

Read the full README View source on GitHub

Reviews

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

Frequently Asked Questions about Esa

esa is an MCP server that connects AI assistants to esa.io, a team documentation and information-sharing service. Its main tools search, read, create, update, publish, archive, and duplicate posts, manage comments and categories, inspect teams and backlinks, retrieve attachments, and provide help for esa search and Markdown syntax.

Install it by configuring an MCP client to run the Docker image or the npm package with npx. Pass an ESA_ACCESS_TOKEN in the client environment, and set LANG when you want a specific interface language.

It needs an esa access token with suitable read and write permissions. The documented choices are the broad read write scopes or the narrower permissions covering comments, posts, categories, tags, attachments, teams, and members. The required scope depends on which operations the assistant will perform.

Yes, it can retrieve, create, update, and delete comments, and list comments for an article or an entire team. Team and post comment listings support pagination.

Yes, it can retrieve attachments from articles and comments. Supported images up to 30 MB may be returned as base64; other files, larger images, or forced signed-URL requests return a signed URL valid for five minutes.

Related MCP servers

All in Workplace & Productivity All alternatives
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 PreviewEsa AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/esa?style=directory)](https://allmcps.com/mcp/esa)
HTML Embed
<a href="https://allmcps.com/mcp/esa"><img src="https://allmcps.com/api/badge/esa?style=directory" alt="Esa on AllMCPs" /></a>