esa — Claude Code MCP server: features and setup
esa connects an AI assistant to team documentation, with tools to search, create, edit, and manage articles, comments, and categories.
claude mcp add esa -e ESA_ACCESS_TOKEN=<ESA_ACCESS_TOKEN> -- npx -y @esaio/esa-mcp-serverWhat esa does
The server connects an MCP client to esa. It can search and retrieve articles, create or edit them, handle comments and categories, inspect team details, and access attachments. Other tools archive an article, remove its WIP status, duplicate it, or restore an earlier revision.
The package also provides esa_recent_posts, a resource for recently updated articles, and esa_summarize_post, a prompt that returns a structured summary. Communication uses STDIO. You need an ESA_ACCESS_TOKEN with suitable permissions; the server cannot access esa without it. Claude Code runs the package through npx.
What it helps with
- search esa articles by topic
- create or revise team documentation
- add a comment to an article
- archive a post or publish it by clearing WIP
- retrieve recent posts and summarize an article
Example prompts for the agent
- Search esa for articles about the API and show me relevant results.
- Create an esa article from this text and place it in the Documentation category.
- Summarize esa article ID 42 and list its main sections.
How to install esa
Platform CLI
claude mcp add esa -e ESA_ACCESS_TOKEN=<ESA_ACCESS_TOKEN> -- npx -y @esaio/esa-mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add esa --env ESA_ACCESS_TOKEN=<ESA_ACCESS_TOKEN> -- npx -y @esaio/esa-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"esa": {
"command": "npx",
"args": [
"-y",
"@esaio/esa-mcp-server"
],
"env": {
"ESA_ACCESS_TOKEN": "<ESA_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"esa": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@esaio/esa-mcp-server"
],
"env": {
"ESA_ACCESS_TOKEN": "<ESA_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e ESA_ACCESS_TOKEN=<ESA_ACCESS_TOKEN> esa npx -y @esaio/esa-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about esa
How do I install esa in Claude Code?
Run claude mcp add esa -e ESA_ACCESS_TOKEN=<ESA_ACCESS_TOKEN> -- npx -y @esaio/esa-mcp-server. Replace the placeholder with your esa access token.
What does the esa MCP server do?
It gives an AI assistant tools to read and manage esa articles, comments, categories, and team information. It also exposes a recent-posts resource and a prompt for summarizing an article.
What is required to use the esa MCP server?
Set ESA_ACCESS_TOKEN with read and write permissions, or with the listed individual scopes. The server communicates over STDIO.
