Claude Desktop

Prerequisites: Install pflow before continuing.

Claude Desktop connects to pflow via MCP server — giving Claude access to workflow discovery and the ability to run workflows directly.

pflow is currently verified to work on macOS. Windows and Linux support is coming soon.

Setup

Open your MCP config file

The config file is located at:

~/Library/Application Support/Claude/claude_desktop_config.json

You can also access it through Claude Desktop: Settings → Developer → Edit Config.

Add pflow to your config

Add the pflow server to your mcpServers object:

{
  "mcpServers": {
    "pflow": {
      "command": "pflow",
      "args": ["mcp", "serve"]
    }
  }
}

If you have other MCP servers configured, add pflow alongside them:

{
  "mcpServers": {
    "existing-server": {
      "command": "...",
      "args": ["..."]
    },
    "pflow": {
      "command": "pflow",
      "args": ["mcp", "serve"]
    }
  }
}

Restart Claude Desktop

Completely quit Claude Desktop and restart it. The app needs to restart to load the new MCP server.

Verify installation

Start a new conversation and ask Claude to list available pflow workflows:

Use pflow to list available workflows

Claude should be able to access pflow’s tools and respond with workflow information.

Troubleshooting

Claude doesn't see pflow tools

Make sure pflow is installed and in your PATH: pflow --version
Check your JSON syntax is valid (use a JSON validator)
Completely quit and restart Claude Desktop (not just close the window)

Config file doesn't exist

Open Claude Desktop, go to Settings → Developer → Edit Config. Claude will create the file for you.

Getting started

Guides

AI tool integration

Claude Desktop

Setup

Troubleshooting

​Setup

​Troubleshooting

Setup

Troubleshooting