esa

This MCP server provides an interface between Claude AI and the esa API, allowing Claude to search, create, update, and manage esa documents through a set of dedicated tools. The server exposes tools such as esa_list_posts, esa_get_post, esa_create_post, esa_update_post, esa_list_comments, esa_get_comment, esa_create_comment, and member-related endpoints like esa_get_members and esa_get_member. You can interact with these tools via natural language prompts to Claude, for example asking to list posts in a team, create a new post with a given title and body, or fetch and review comments on a post. The server handles authentication by using the ESA_ACCESS_TOKEN you provide in the environment and targets your specified ESA_TEAM, enabling seamless operations within your esa workspace.

Prerequisites:

• Node.js 18 or higher
• An esa API access token
• Your esa team name

Installation steps:

1. Install globally (recommended):

# Install globally
npm install -g @kajirita2002/esa-mcp-server

2. Or run directly with npx:

# Or use directly with npx
npx @kajirita2002/esa-mcp-server

3. Set up environment variables (example):

export ESA_ACCESS_TOKEN="your_esa_access_token"
export ESA_TEAM="your_team_name"

4. Configure MCP (example mcp_config.json):

"esa": {
  "command": "npx",
  "args": ["-y", "@kajirita2002/esa-mcp-server"],
  "env": {
    "ESA_ACCESS_TOKEN": "your_esa_access_token",
    "ESA_TEAM": "your_team_name"
  }
}

5. Start the server (if using npm script, see next section):

# Start the server
npm start

Note: Ensure your environment variables are set in the runtime environment where the MCP runs so the esa API can be authenticated properly.

Tips and notes:

• Make sure the ESA_ACCESS_TOKEN has the necessary permissions for the team you are targeting.
• The mcp_config.json snippet uses the npx command with the package @kajirita2002/esa-mcp-server; you can also run the server directly if you prefer a local installation.
• When using esa_list_posts or esa_get_post, you can tailor responses with include fields (e.g., comments, stargazers).
• If you encounter 401/403 errors, regenerate a new ESA access token and update ESA_ACCESS_TOKEN in your environment.
• The server supports common ese operations like creating and updating posts, listing and retrieving comments, and managing team members.