Esa Mcp Server

io.github.koki-developPublished by GitHub account koki-developv0.3.2Updated Oct 25, 2026

A Model Context Protocol (MCP) server for esa.io

VerifiedSTDIODesktop onlyProductivity & WorkflowKnowledge & Memory

Overview

AI-generated overview

A local MCP server for esa.io that lets an assistant search, read, create, update and delete team posts, tags and comments.

What you can do
Search and read posts with filtering, sorting and pagination, including comments and stargazers; post bodies are truncated in list results and full in single-post reads. Create, update and delete posts with titles, Markdown content, tags, categories and WIP status. List all team tags with post counts. Read, create, update and delete comments on posts. A read-only flag limits the server to the four retrieval tools.
When to use it
Useful when your team documents work in esa.io and you want an assistant to look up posts, summarize or draft content, and manage comments without leaving the chat. Consider the read-only mode if you only need retrieval.
Requirements
Runs locally via npx (Node.js) or Docker. Needs an esa.io team name in ESA_TEAM and a personal access token generated from the team's application settings in ESA_ACCESS_TOKEN. Network access to esa.io.
Before you install
The personal access token in ESA_ACCESS_TOKEN grants access to your esa team and is passed to the server process. Write tools create, update and delete posts and comments, and deletions are permanent and unrecoverable; enable the read-only flag to prevent this. The README notes an official esa MCP server has been released and recommends using it instead.

Installation

In SourceWeft

  1. Open Esa Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[!IMPORTANT] An official MCP server has been released. Please use the official server going forward.

esa MCP Server

[Version] [License] [Docker]

A Model Context Protocol (MCP) server for esa.io.

Table of Contents

Usage

Prerequisites

Before using this MCP server, you need to generate a personal access token from your esa.io team:

  1. Go to https://<TEAM_NAME>.esa.io/user/applications
  2. Create a new personal access token
  3. Copy the token for configuration

Configuration

You can run the server either via npx or Docker.

Using npx

Add the following configuration to your MCP client:

json
{  "mcpServers": {    "esa": {      "command": "npx",      "args": [        "-y",        "@koki-develop/esa-mcp-server@latest"      ],      "env": {        "ESA_TEAM": "<your-team-name>",        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"      }    }  }}

Replace <your-team-name> and <your-personal-access-token> with your team name and personal access token.

Using Docker

If you prefer Docker, use the following configuration:

json
{  "mcpServers": {    "esa": {      "command": "docker",      "args": [        "run",        "-i",        "--rm",        "-e",        "ESA_TEAM",        "-e",        "ESA_ACCESS_TOKEN",        "ghcr.io/koki-develop/esa-mcp-server:latest"      ],      "env": {        "ESA_TEAM": "<your-team-name>",        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"      }    }  }}
Read-only Mode

To enable read-only mode that only allows read operations, add the --readonly flag.

Using npx:

json
{  "mcpServers": {    "esa": {      "command": "npx",      "args": [        "-y",        "@koki-develop/esa-mcp-server@latest",        "--readonly"      ],      "env": {        "ESA_TEAM": "<your-team-name>",        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"      }    }  }}

Using Docker:

json
{  "mcpServers": {    "esa": {      "command": "docker",      "args": [        "run",        "-i",        "--rm",        "-e",        "ESA_TEAM",        "-e",        "ESA_ACCESS_TOKEN",        "ghcr.io/koki-develop/esa-mcp-server:latest",        "--readonly"      ],      "env": {        "ESA_TEAM": "<your-team-name>",        "ESA_ACCESS_TOKEN": "<your-personal-access-token>"      }    }  }}

In read-only mode, only the following operations are available:

  • get_posts - retrieve posts
  • get_post - retrieve a specific post
  • get_tags - retrieve tags
  • get_post_comments - retrieve post comments

Write operations (create_post, update_post, delete_post, create_post_comment, update_comment, delete_comment) are disabled.

MCP Tools

Posts

ToolDescription
get_postsRetrieve a list of posts from the esa team. Supports search queries, filtering, sorting, and pagination. Returns post metadata including title, content, tags, categories, author information, and engagement metrics (comments, stars, watches). Optionally includes comments and stargazers with the include parameter. Supports nested inclusion like 'comments,comments.stargazers'. Note: Post content (body_md) is truncated to 300 characters with a body_truncated field indicating if truncation occurred to reduce context size.
get_postRetrieve a specific post from the esa team by post number. Returns complete post details including title, content (markdown), tags, category, author information, revision history, and engagement metrics. Optionally includes comments and stargazers. Supports nested inclusion like 'comments,comments.stargazers'.
create_postCreate a new post in the esa team. Requires a title and optionally accepts content, tags, category, WIP status, and other metadata. Returns the created post information including the assigned post number and URL.
update_postUpdate an existing post in the esa team. Requires a post number and optionally accepts updated content, tags, category, WIP status, and other metadata. Returns the updated post information including revision details.
delete_postDelete an existing post from the esa team. Requires a post number. The post will be permanently deleted and cannot be recovered. Returns a confirmation message upon successful deletion.

Tags

ToolDescription
get_tagsGet a list of all tags used in the esa team. Returns tags with their names and the number of posts they are attached to, sorted by post count in descending order. Supports pagination.

Comments

ToolDescription
get_post_commentsRetrieve a list of comments for a specific post from the esa team. Requires a post number and supports pagination. Returns comment metadata including content, author information, timestamps, and engagement metrics (stars).
create_post_commentCreate a new comment on an existing post in the esa team. Requires a post number and comment content in Markdown format. Returns the created comment information including ID, content, timestamps, and author details.
update_commentUpdate an existing comment on a post in the esa team. Requires a comment ID and new content in Markdown format. Returns the updated comment information including content, timestamps, and author details.
delete_commentDelete an existing comment from the esa team. Requires a comment ID. The comment will be permanently deleted and cannot be recovered. Returns a confirmation message upon successful deletion.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2025 Koki Sato

Source: README.md at commit c81f79c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.3.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts