# FlowDot

FlowDot connects an MCP client to FlowDot workflows, apps, knowledge bases, and agent tools. Use it to build, inspect, and run workflows from Claude Code.

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

## What it does

FlowDot exposes FlowDot capabilities to an MCP client: workflow graphs, custom nodes, apps, knowledge bases, agent toolkits, and community objects. An agent can create workflows, add nodes and connections, validate the graph, start executions, and inspect their status.

The server also covers RAG knowledge bases, agent recipes, sharing, and workflow discovery. Set `FLOWDOT_API_TOKEN` before connecting it, then run `npx -y @flowdot.ai/mcp-server`. Recipes are designed through MCP but executed with the FlowDot CLI `@flowdot.ai/cli`, since they are long-running programs that need local file, code, and shell access.

For Claude Code, the setup uses `claude mcp add`. The next session loads the server configuration.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FLOWDOT_API_TOKEN`, `FLOWDOT_HUB_URL` — 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 --env FLOWDOT_API_TOKEN=<FLOWDOT_API_TOKEN> --env FLOWDOT_HUB_URL=<FLOWDOT_HUB_URL> --transport stdio flowdot -- npx -y @flowdot.ai/mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add flowdot --env FLOWDOT_API_TOKEN=<FLOWDOT_API_TOKEN> --env FLOWDOT_HUB_URL=<FLOWDOT_HUB_URL> -- npx -y @flowdot.ai/mcp-server
```
Replace <…> with your own values

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FLOWDOT_API_TOKEN=<FLOWDOT_API_TOKEN> -e FLOWDOT_HUB_URL=<FLOWDOT_HUB_URL> flowdot npx -y @flowdot.ai/mcp-server
```
Replace <…> with your own values

## When to use it
- build a workflow graph from nodes
- validate workflow connections and settings
- start a workflow and inspect its status
- design a multi-step agent recipe
- query a knowledge base for RAG

## Example prompts
- Build a FlowDot workflow for processing this data and validate its graph.
- List the available FlowDot nodes and add the needed ones to a new workflow.
- Design an agent recipe with branching and parallel steps.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
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