# PROCESIO

> PROCESIO is an open-source MCP server for developer tools. Build, run, validate and audit PROCESIO automation processes from your own AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux, API
- **Repository:** https://github.com/procesio-externals/procesio-cli
- **MCP Registry name:** io.github.Procesio-Externals/procesio-cli
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

PROCESIO is an automation platform, and this package lets an assistant drive a workspace over its public API: processes, forms, documents and custom actions. It ships as a Python command-line tool, an MCP server (a stdio package on PyPI and a bundled .mcpb file) and a Claude Code plugin with four skills.

Credentials are kept in the operating system's own store (Windows Credential Manager, macOS Keychain or the Linux keyring), not in files in the repo, with encrypted-file and environment options for headless machines. You can authenticate with a user account that reaches all workspaces, or an API key pinned to one workspace by its GUID. Every command prints a single JSON object so output can be piped into other scripts.

Optional extras add real-browser form testing, Excel reading and SQL Server or MySQL queries. Python 3.11 or newer is required, and Intel Macs are not covered by the pinned wheels.

## Features

- **Workspace automation:** Runs and manages processes, forms, documents and custom actions.
- **Two auth modes:** Use a user account across workspaces or an API key tied to one.
- **OS secret storage:** Stores credentials in the system keychain rather than a file.
- **Claude Code plugin:** Installs the MCP server and four skills with two commands.
- **JSON output:** Each tool prints one JSON object, with errors as structured JSON.
- **Optional extras:** Browser form tests, Excel and SQL database support.

## Good for

- Have an assistant build or edit PROCESIO processes
- Run a process with a payload from a script or CI
- Validate and audit forms and documents
- Pin an automation to one workspace with an API key

## Install

### Claude Code (Terminal)

```sh
claude mcp add procesio-cli -- uvx procesio-cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "procesio-cli": {
      "command": "uvx",
      "args": [
        "procesio-cli"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "procesio-cli": {
      "command": "uvx",
      "args": [
        "procesio-cli"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "procesio-cli": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "procesio-cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "procesio-cli": {
      "command": "uvx",
      "args": [
        "procesio-cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "procesio-cli": {
      "command": "uvx",
      "args": [
        "procesio-cli"
      ]
    }
  }
}
```

## FAQ

### What does it need to run?

Python 3.11 and uv, plus a PROCESIO workspace and credentials.

### Where are credentials stored?

In the OS secret store under agents-and-tools:procesio, or in an encrypted file or environment on headless machines.

### What is the difference between a user account and an API key?

A user account reaches everything it can across workspaces; an API key reaches one workspace and needs that workspace's GUID.

### How do I add it to Claude Code?

Run /plugin marketplace add Procesio-Externals/procesio-cli then /plugin install procesio@procesio-cli.

### Is PROCESIO free?

Yes. PROCESIO is open source, so you can use and self-host it for free.

### How do I add PROCESIO to Claude Code?

Run this command in your terminal: claude mcp add procesio-cli -- uvx procesio-cli

### What are the best alternatives to PROCESIO?

The closest alternatives to PROCESIO are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/procesio
