Electron MCP Server

v1.5.0Developer Toolsstable

A cross-platform desktop application that runs a Model Context Protocol server, allowing AI applications like Claude Desktop to easily connect without requiring npx or Node.js installation.

mcpelectronautomationdesktopmodel-context-protocol
Share:
63
Stars
0
Downloads
0
Weekly
0/5

What is Electron MCP Server?

Electron MCP Server is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to cross-platform desktop application that runs a model context protocol server, allowing ai applications like claude desktop to easily connect without requiring npx or node.js installation.

A cross-platform desktop application that runs a Model Context Protocol server, allowing AI applications like Claude Desktop to easily connect without requiring npx or Node.js installation.

This server falls under the Developer Tools and Browser Automation categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A cross-platform desktop application that runs a Model Conte

Use Cases

Run MCP servers in desktop applications without Node.js installation.
Enable Claude Desktop and other AI apps to control desktop automation tasks.
Deploy cross-platform desktop integrations with AI assistance.
halilural

Maintainer

LicenseMIT License
Languagetypescript
Versionv1.5.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y electron-mcp-server

Manual Installation

npx -y electron-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Electron MCP Server

Electron MCP Server is a cross-platform desktop automation server that bridges AI assistants with Electron applications using the Chrome DevTools Protocol, eliminating the need for users to have Node.js installed separately. It exposes tools to launch Electron apps, capture screenshots, send JavaScript commands, inspect window structures, stream logs, and create distribution builds — all through natural language via MCP. Teams building or testing Electron applications can use it to automate UI interactions, perform visual debugging, and integrate AI-driven testing into their development workflows.

Prerequisites

  • Node.js 18+ and npm (for npx-based installation)
  • An Electron application to automate or test
  • An MCP-compatible client such as Claude Desktop or VS Code with MCP support
  • Optional: a 32-byte hex string for screenshot encryption (SCREENSHOT_ENCRYPTION_KEY)
1

Install the Electron MCP Server

Install the server globally via npm, or use npx to run it on-demand without a permanent installation. The npx approach is recommended for VS Code and Claude Desktop integrations.

# Global install:
npm install -g electron-mcp-server

# Or use via npx (no install needed):
npx -y electron-mcp-server
2

Choose a security level

The server supports four security levels via the SECURITY_LEVEL environment variable. Use 'balanced' (the default) for most development and testing scenarios — it enables safe UI interactions while restricting higher-risk operations.

# Security levels:
# strict     - Maximum security, minimal functionality
# balanced   - Default, safe UI interactions (recommended)
# permissive - Extended functionality
# development - Minimal restrictions
3

Configure your MCP client (Claude Desktop)

Add the electron-mcp-server to your Claude Desktop config file at ~/Library/Application Support/Claude/claude_desktop_config.json.

{
  "mcpServers": {
    "electron": {
      "command": "npx",
      "args": ["-y", "electron-mcp-server"],
      "env": {
        "SECURITY_LEVEL": "balanced"
      }
    }
  }
}
4

Configure your MCP client (VS Code)

For VS Code, add the server to your .vscode/mcp.json settings file using the same command and arguments.

{
  "mcp": {
    "servers": {
      "electron": {
        "command": "npx",
        "args": ["-y", "electron-mcp-server"],
        "env": {
          "SECURITY_LEVEL": "balanced"
        }
      }
    }
  }
}
5

Restart your MCP client and begin automating

Restart Claude Desktop or reload VS Code so it connects to the new server. You can then ask Claude to launch an Electron app, take screenshots, or interact with UI elements.

Electron MCP Server Examples

Client configuration

Claude Desktop configuration for Electron MCP Server with balanced security level.

{
  "mcpServers": {
    "electron": {
      "command": "npx",
      "args": ["-y", "electron-mcp-server"],
      "env": {
        "SECURITY_LEVEL": "balanced"
      }
    }
  }
}

Prompts to try

Natural language prompts leveraging the Electron MCP Server's automation tools.

- "Launch my Electron app at /path/to/app and take a screenshot"
- "Click the button with text 'Submit' in the open Electron window"
- "Fill in the username field with 'testuser' and the password field with 'secret'"
- "Read the application logs from the running Electron process"
- "Build a distribution package of my Electron app"

Troubleshooting Electron MCP Server

Electron app does not respond to commands

Ensure the Electron app was launched via the `launch_electron_app` tool, not started separately. The DevTools Protocol connection is established at launch time and is required for subsequent commands.

Screenshot encryption errors

If you set SCREENSHOT_ENCRYPTION_KEY, it must be exactly 32 bytes in hex format (64 hex characters). Either use a valid key or omit the variable entirely to disable encryption.

Commands blocked by security policy

If needed operations are blocked, change SECURITY_LEVEL from 'balanced' to 'permissive' in your config. For CI/CD or testing environments where restrictions are less needed, 'development' mode disables most limits.

Frequently Asked Questions about Electron MCP Server

What is Electron MCP Server?

Electron MCP Server is a Model Context Protocol (MCP) server that cross-platform desktop application that runs a model context protocol server, allowing ai applications like claude desktop to easily connect without requiring npx or node.js installation. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Electron MCP Server?

Install via npm with the command: npx -y electron-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Electron MCP Server?

Electron MCP Server works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Electron MCP Server free to use?

Yes, Electron MCP Server is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "electron-mcp-server": { "command": "npx", "args": ["-y", "electron-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Electron MCP Server?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides