esa
Official MCP server for esa.io, the team documentation service, with posts and comments
- 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-serverAdd 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 authenticationRequiredESA_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.



