# floom

The floom MCP server connects an agent to a runtime for background AI workers: deploy, run, schedule and inspect every execution.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 46
- Author: floomhq
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/floomhq/floom
- Updated: 2026-10-02
- HTML: https://affpapa.org/en/nevibecode/mcp/floom

## What it does

Floom is a self-hosted runtime for background AI workers. A worker is a folder holding `worker.yml` plus either `run.py` for a script or `SKILL.md` for a plain-English agent. The manifest declares inputs, outputs, trigger, secrets and the tools that worker may call. Script workers execute inside E2B sandbox microVMs with an isolated filesystem, environment and process; platform secrets stay out of the sandbox.

Triggers cover manual runs, cron schedules, webhooks and Composio events. Each run keeps logs, outputs, tool calls and approval state, and you can open, replay or roll back it from the UI. The MCP server is how an agent reaches all of that. There is no per-task fee from Floom itself — you pay for E2B sandbox seconds and for your model provider.

You need `FLOOM_BASE_URL` and `FLOOM_API_KEY` before anything works. Point them at your own Floom instance. Agent-mode workers built on `SKILL.md` run inside the API process and are not microVM-isolated, so keep those bundles trusted.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FLOOM_BASE_URL`, `FLOOM_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add floom -e FLOOM_BASE_URL=<FLOOM_BASE_URL> -e FLOOM_API_KEY=<FLOOM_API_KEY> -- npx -y @floomhq/mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add floom --env FLOOM_BASE_URL=<FLOOM_BASE_URL> --env FLOOM_API_KEY=<FLOOM_API_KEY> -- npx -y @floomhq/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "floom": {
            "command": "npx",
            "args": [
                "-y",
                "@floomhq/mcp-server"
            ],
            "env": {
                "FLOOM_BASE_URL": "<FLOOM_BASE_URL>",
                "FLOOM_API_KEY": "<FLOOM_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "floom": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@floomhq/mcp-server"
            ],
            "env": {
                "FLOOM_BASE_URL": "<FLOOM_BASE_URL>",
                "FLOOM_API_KEY": "<FLOOM_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FLOOM_BASE_URL=<FLOOM_BASE_URL> -e FLOOM_API_KEY=<FLOOM_API_KEY> floom npx -y @floomhq/mcp-server
```
Replace <…> with your own values

## When to use it
- run a Python script on a cron schedule unattended
- expose one worker to a UI, REST and an agent at once
- restrict which tools an agent may call
- keep logs and output files for every run
- roll back a failed run and start it again

## Example prompts
- List my floom workers and run `github-digest`
- Deploy the worker in `workers/my-worker`
- Show me the logs from the last `github-digest` run

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md