What is ELEMENT.FM MCP Server?

ELEMENT.FM MCP Server is a backend implementation for managing podcast shows and episodes, part of the ELEMENT.FM platform. It provides workspace management, show/episode handling, and AI-powered audio processing features.

How to use ELEMENT.FM MCP Server?

1. Obtain an API key and set it as an environment variable: export API_KEY=your_api_key_here
2. You can run the server either:
   • Via Python using the published package: uvx elementfm_mcp_server (for standard I/O mode) or uvx elementfm_mcp_server sse (for Server-Sent Events mode)
   • Via Docker: docker run --rm -d -e API_KEY=api_key -p 8000:8000 registry.gitlab.com/elementfm/mcp:latest

Key features of ELEMENT.FM MCP Server?

• Workspace management (creation, listing, retrieval)
• Show management (create, list, get, update)
• Episode management (create, list, get, update, publish)
• AI-powered features:
  • Transcription
  • Chapter generation
  • Show notes generation
• Workspace invitations
• Workspace search functionality

Use cases of ELEMENT.FM MCP Server?

1. Building a complete podcast management platform
2. Implementing AI-powered audio processing for podcast episodes
3. Managing team collaborations through workspaces
4. Automating episode publishing workflows
5. Integration with frontend applications via API

FAQ from ELEMENT.FM MCP Server?

• What is the difference between standard and SSE modes?

  Standard mode uses regular HTTP requests, while SSE mode enables real-time communication via Server-Sent Events, typically used for live updates.

• Can I self-host the server?

  Yes, you can self-host by setting up the API_KEY and optionally configuring a custom frontend URL.

• What license is this project under?

  The project is licensed under GNU General Public License v3.0 or later.

elementfm / mcp · GitLab

=============== Skip to content

GitLab

• Menu

*   [Why GitLab](https://about.gitlab.com/why-gitlab)
*   [Pricing](https://about.gitlab.com/pricing)
*   [Contact Sales](https://about.gitlab.com/sales)
*   [Explore](https://gitlab.com/explore)

• Why GitLab

• Pricing

• Contact Sales

• Explore

• Sign in

• Get free trial

Primary navigation

Search or go to…

Project

• M mcp
• Manage

*   [Activity](https://gitlab.com/elementfm/mcp/activity)
*   [Members](https://gitlab.com/elementfm/mcp/-/project_members)
*   [Labels](https://gitlab.com/elementfm/mcp/-/labels)

• Plan

*   [Issues](https://gitlab.com/elementfm/mcp/-/issues)
*   [Issue boards](https://gitlab.com/elementfm/mcp/-/boards)
*   [Milestones](https://gitlab.com/elementfm/mcp/-/milestones)
*   [Wiki](https://gitlab.com/elementfm/mcp/-/wikis/home)

• Code

*   [Merge requests](https://gitlab.com/elementfm/mcp/-/merge_requests)
*   [Repository](https://gitlab.com/elementfm/mcp/-/tree/dev)
*   [Branches](https://gitlab.com/elementfm/mcp/-/branches)
*   [Commits](https://gitlab.com/elementfm/mcp/-/commits/dev?ref_type=heads)
*   [Tags](https://gitlab.com/elementfm/mcp/-/tags)
*   [Repository graph](https://gitlab.com/elementfm/mcp/-/network/dev?ref_type=heads)
*   [Compare revisions](https://gitlab.com/elementfm/mcp/-/compare?from=dev&to=dev)
*   [Snippets](https://gitlab.com/elementfm/mcp/-/snippets)

• Build

*   [Pipelines](https://gitlab.com/elementfm/mcp/-/pipelines)
*   [Jobs](https://gitlab.com/elementfm/mcp/-/jobs)
*   [Pipeline schedules](https://gitlab.com/elementfm/mcp/-/pipeline_schedules)
*   [Artifacts](https://gitlab.com/elementfm/mcp/-/artifacts)

• Deploy

*   [Releases](https://gitlab.com/elementfm/mcp/-/releases)
*   [Package registry](https://gitlab.com/elementfm/mcp/-/packages)
*   [Container registry](https://gitlab.com/elementfm/mcp/container_registry)
*   [Model registry](https://gitlab.com/elementfm/mcp/-/ml/models)

• Operate

*   [Environments](https://gitlab.com/elementfm/mcp/-/environments)
*   [Terraform modules](https://gitlab.com/elementfm/mcp/-/terraform_module_registry)

• Monitor

*   [Incidents](https://gitlab.com/elementfm/mcp/-/incidents)
*   [Service Desk](https://gitlab.com/elementfm/mcp/-/issues/service_desk)

• Analyze

*   [Value stream analytics](https://gitlab.com/elementfm/mcp/-/value_stream_analytics)
*   [Contributor analytics](https://gitlab.com/elementfm/mcp/-/graphs/dev?ref_type=heads)
*   [CI/CD analytics](https://gitlab.com/elementfm/mcp/-/pipelines/charts)
*   [Repository analytics](https://gitlab.com/elementfm/mcp/-/graphs/dev/charts)
*   [Model experiments](https://gitlab.com/elementfm/mcp/-/ml/experiments)

Help

•   *   [Help](https://gitlab.com/help)
  

  • Support
  • GitLab documentation
  • Compare GitLab plans
  • GitLab community forum
  • Contribute to GitLab
  • Provide feedback
  • Privacy statement

•   *    Keyboard shortcuts ?
  

  • What's new 4

SnippetsGroupsProjects

1. elementfm
2. mcp

M

mcp

Star0

Project ID: 68506438

More actions

• Copy project ID: 68506438

Project information

• 12 Commits

• 1 Branch

• 3 Tags

• 2 Releases

• README

• GNU General Public License v3.0 or later

Created on

March 30, 2025

dev

Select Git revision

• Selected

• dev default protected

• Tags 3

• 0.0.5

• 0.0.4

• 2025-04-10

4 results

1. mcp

Find file

Code

•   *    Clone with SSH      
  

•   *    Clone with HTTPS      
  

• Open in your IDE

  • Visual Studio Code (SSH)
  • Visual Studio Code (HTTPS)
  • IntelliJ IDEA (SSH)
  • IntelliJ IDEA (HTTPS)

• Download source code

  • zip
  • tar.gz
  • tar.bz2
  • tar

Download

• Download source code
  • zip
  • tar.gz
  • tar.bz2
  • tar

Code

• Clone with SSH
• Clone with HTTPS

Actions

• Copy permalink y

removing temp files

Steven Fusco authored 1 month ago

Verified

13deb7dd

History

13deb7dd1 month ago

History

Name	Last commit	Last update
elementfm_mcp_server	removing temp files	1 month ago
.gitignore	initial checkin	2 months ago
.gitlab-ci.yml	initial checkin	2 months ago
.python-version	initial checkin	2 months ago
Dockerfile	converting files to mp3 before uploading	1 month ago
LICENSE	initial checkin	2 months ago
Makefile	listings and publishing working	2 months ago
README.md	updated readme	2 months ago
devbox.json	listings and publishing working	2 months ago
devbox.lock	listings and publishing working	2 months ago
pyproject.toml	converting files to mp3 before uploading	1 month ago
uv.lock	invitations working	2 months ago

README.md

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