MCP WebSocket Server

MCP WebSocket Server is an MCP server that facilitates email operations and mailbox querying over a WebSocket connection. It connects an AI client to mail services, allowing developers and users to interact with email messages programmatically using standard Model Context Protocol tooling. By exposing dedicated tools for connection testing, mail retrieval, content searching, and mailbox statistics, the server enables large language models to inspect and analyze incoming communications. Built on Node.js, the project provides a stdio bridge script that translates local standard input and output streams into remote or local WebSocket commands. This architecture allows AI assistants like Claude Desktop to connect either to a locally running instance or to a cloud deployment hosted on platforms like Render.com. Users can monitor email volume, search specific mail content, and retrieve the latest messages directly from their conversational interface, keeping email-driven workflows integrated into their assistant environment.

Category: Communication & Messaging

Tags: email, imap, messaging, smtp, websocket

Visit MCP WebSocket Server

How to install and configure MCP WebSocket Server

To install and configure MCP WebSocket Server, follow these steps: 1. Clone the repository and install dependencies locally: bash npm install npm run build 2. Start the local server if hosting locally: bash npm start 3. Configure Claude Desktop by editing your %APPDATA%\Claude\claude_desktop_config.json file to bridge stdio to the WebSocket endpoint: For a deployed remote instance: json { "mcpServers": { "mail-mcp-server": { "command": "node", "args": [ "C:\\path\\to\\stdio-bridge.js", "wss://mcp-websocket-server.onrender.com/mcp" ] } } } For a local instance: json { "mcpServers": { "mail-mcp-server": { "command": "node", "args": [ "C:\\path\\to\\stdio-bridge.js", "ws://localhost:3000/mcp" ] } } } 4. Restart Claude Desktop to verify the connection.

What you can do with MCP WebSocket Server

• Retrieve the latest incoming email messages for a target address via the mail_getir tool. * Search through mail content and message bodies using the mail_ara tool to locate specific information. * Generate summary reports and inspect overall email metrics by running the mail_istatistik tool. * Test and monitor active WebSocket connections to the mail server using the test_baglanti command. * Deploy a remote mail bridge on Render.com to support cloud-based AI agent communication.

Key facts

• https://github.com/henrydyson/mcp-websocket-server
• Communication & Messaging
• email, imap, messaging, smtp, websocket

Part of MCP Servers

What is MCP WebSocket Server?

MCP WebSocket Server is a Model Context Protocol server that runs over WebSockets to manage mail operations. It provides an interface for AI assistants to fetch recent emails, search through message content, and display mail statistics.

What tools are available in MCP WebSocket Server?

The server exposes four primary tools: test_baglanti for verifying server connectivity, mail_getir for fetching the latest email for a specified address, mail_ara for searching email text, and mail_istatistik for displaying mailbox statistics.

Which MCP clients work with MCP WebSocket Server?

The server works with Claude Desktop and any client supporting standard Model Context Protocol connections. It includes a stdio bridge script that allows clients using standard input and output to communicate with its WebSocket endpoints.

Is MCP WebSocket Server open source?

Yes, MCP WebSocket Server is open-source software released under the MIT license. You can inspect, modify, and host the code directly from its GitHub repository.