Build and supervise scheduled AI workers with an open-source runtime, human approvals, run logs, REST API, and MCP tools.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add floom --env FLOOM_BASE_URL='<FLOOM_BASE_URL>' --env FLOOM_API_KEY='<FLOOM_API_KEY>' -- npx -y @floomhq/mcp-server~/.codex/config.toml
[mcp_servers.floom]
command = "npx"
args = ["-y", "@floomhq/mcp-server"]
env = { FLOOM_BASE_URL = "<FLOOM_BASE_URL>", FLOOM_API_KEY = "<FLOOM_API_KEY>" }
# codex mcp add floom --env FLOOM_BASE_URL='<FLOOM_BASE_URL>' --env FLOOM_API_KEY='<FLOOM_API_KEY>' -- npx -y @floomhq/mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"floom": {
"command": "npx",
"args": [
"-y",
"@floomhq/mcp-server"
],
"env": {
"FLOOM_BASE_URL": "<FLOOM_BASE_URL>",
"FLOOM_API_KEY": "<FLOOM_API_KEY>"
}
}
}
}.vscode/mcp.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>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"floom": {
"command": "npx",
"args": [
"-y",
"@floomhq/mcp-server"
],
"env": {
"FLOOM_BASE_URL": "<FLOOM_BASE_URL>",
"FLOOM_API_KEY": "<FLOOM_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"floom": {
"command": "npx",
"args": [
"-y",
"@floomhq/mcp-server"
],
"env": {
"FLOOM_BASE_URL": "<FLOOM_BASE_URL>",
"FLOOM_API_KEY": "<FLOOM_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"floom": {
"command": "npx",
"args": [
"-y",
"@floomhq/mcp-server"
],
"env": {
"FLOOM_BASE_URL": "<FLOOM_BASE_URL>",
"FLOOM_API_KEY": "<FLOOM_API_KEY>"
}
}
}
}Environment variables
FLOOM_BASE_URLFLOOM_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.