elementfm-mcp-server 0.4.0

MCP (Model Control Protocol) server for Element.fm, providing tools for managing podcasts

ELEMENT.FM MCP Server

This is the MCP server implementation for the ELEMENT.FM API.

Configuration

Before using the server, you need to set up your API key as an environment variable:

export API_KEY=your_api_key_here

You can also optionally configure the frontend URL if you are self hosting (defaults to https://app.element.fm):

export FRONTEND_ROOT_URL=https://your-custom-url.com

Python Usage

Pre-built script is published to pypi

uvx elementfm_mcp_server  # For standard I/O mode
# or
uvx elementfm_mcp_server sse   # For Server-Sent Events mode port 8000

Docker Usage

To build the server with docker you can do

make

Or you can use the pre-build contaner image

docker run --rm -d -e API_KEY=api_key -p 8000:8000 registry.gitlab.com/elementfm/mcp:latest

Example Cursor mcp.json:

{
  "mcpServers": {
    "elementfm": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Features

The MCP server provides the following functionality:

• Workspace management (create, list, get)
• Show management (create, list, get, update)
• Episode management (create, list, get, update, publish)
• AI features (transcription, chapter generation, show notes generation)
• Workspace invitations
• Workspace search

Development

To set up the development environment:

devbox shell

License

GPLv3