Skip to content
MCP server

esa

Official MCP server for esa.io, the team documentation service, with posts and comments

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.15.2
Listing updated
today

Similar MCP servers

About esa

esa is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

The server is published by the esa team and runs locally over stdio, from npm or a container image, using an esa access token with read and write scopes (the README recommends a personal access token v2). A LANG setting controls the interface language. The README is written in Japanese with an English version linked.

Beyond reading and searching articles, it can create, update, append to or prepend to posts without re-fetching the body, archive or ship a post, duplicate it (including to another team) and roll back to a prior revision. Comment tools cover create, edit, delete and listing, and category tools make it easy to map out and reorganise a team's category tree. Attachments under 30 MB in common image formats return as base64, while others return a five-minute signed URL.

It also exposes a recent-posts resource and a summarise-post prompt, and the package ships a registry.json listing its tools, resources and prompts. The code is MIT licensed.

Install

Run in a terminal

claude mcp add esa --env ESA_ACCESS_TOKEN='<ESA_ACCESS_TOKEN>' -- npx -y @esaio/esa-mcp-server

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "esa": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@esaio/esa-mcp-server"
      ],
      "env": {
        "ESA_ACCESS_TOKEN": "<ESA_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ESA_ACCESS_TOKENAccess token for esa.io API authenticationRequired
  • ESA_ACCESS_TOKENAccess token for esa.io API authenticationRequired

Tools this server provides (28)

Taken from the project documentation; the running server may differ.

esa_get_teams
List your esa teams
esa_get_team_stats
Team statistics
esa_get_team_tags
Tags and usage counts
esa_get_team_members
Members and roles
esa_search_posts
Search articles
esa_get_post
Get an article by ID
esa_get_post_backlinks
List posts that reference an article
esa_create_post
Create an article
esa_update_post
Update an article
esa_append_post
Append to an article body
esa_prepend_post
Prepend to an article body
esa_archive_post
Archive an article
esa_ship_post
Ship an article (remove WIP)
esa_duplicate_post
Duplicate an article
esa_rollback_post_revision
Roll back to a revision
esa_get_comment
Get a comment
esa_create_comment
Add a comment
esa_update_comment
Edit a comment
esa_delete_comment
Delete a comment
esa_get_post_comments
List comments on a post
esa_get_team_comments
List team comments
esa_get_categories
List categories under a path
esa_get_top_categories
List top-level categories
esa_get_all_category_paths
List all category paths with counts
esa_get_attachment
Fetch an attachment
esa_get_search_options_help
Search syntax help
esa_get_markdown_syntax_help
Markdown syntax help
esa_search_help
Search esa documentation

What it does

Full post lifecycle
Create, update, append, prepend, archive, ship, duplicate and roll back articles.
Comments
Read, add, edit and delete comments on posts or across the team.
Category mapping
List category paths with post counts, filtered by prefix or match.
Attachment retrieval
Images up to 30 MB come back as base64, others as short-lived signed URLs.
Search help
Built-in help tools for esa search syntax, Markdown syntax and docs.
Resource and prompt
A recent-posts resource and a summarise-post prompt.

Good for

  • Search and summarise team documentation from an assistant
  • Draft a new WIP article in a chosen category
  • Append meeting notes to an existing post
  • Plan a category reorganisation using path counts
  • Review backlinks before archiving a post

Pricing

Open source

MIT-licensed server; requires an esa.io account and access token

esa FAQ

What credentials are needed?

An esa access token, supplied as ESA_ACCESS_TOKEN, with read/write or a defined set of read and write scopes.

How do I run it?

Through docker or npx in your MCP client config, over stdio.

Is it official?

The registry entry calls it the official MCP server for esa.io.

Which licence?

MIT.

Is esa free?

Yes. esa is open source, so you can use and self-host it for free.

How do I add esa to Claude Code?

Run this command in your terminal: claude mcp add esa --env ESA_ACCESS_TOKEN='<ESA_ACCESS_TOKEN>' -- npx -y @esaio/esa-mcp-server

What are the best alternatives to esa?

The closest alternatives to esa are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Concord MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers