# Veilleur

> Veilleur is an open-source MCP server for communication. Windows Discord MCP server where you approve each plan before it changes your server. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, CLI
- **Repository:** https://github.com/nopaperspray/veilleur
- **MCP Registry name:** io.github.NoPaperSpray/veilleur
- **Categories:** [communication](https://ai-powered.com/categories/communication), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Veilleur is designed so an AI never gets unchecked control of a Discord server. The assistant prepares a plan, such as creating a Welcome category with a read-only rules channel and a Moderator role. A window then opens on your PC, you tick the box to approve, and only then does it run. Approval covers that exact plan, lasts 10 minutes and works for a single execution; if the server or a target changes meanwhile, a new plan is needed.

Before running, it backs up the server structure, roles, some settings and directly affected members or messages to a local folder. A rollback can be requested, but the README is plain that it is not a perfect undo: recreated channels get new IDs, and deleted messages, attachments and reactions do not come back.

It can create, edit and delete channels, categories and roles, manage permissions, change nicknames and timeouts, and send embeds or edit the bot's own messages. It needs a Discord bot token and guild ID, runs only on Windows with Python 3.11, and the approval window uses Tkinter. The README is written in French with an English version, and its author says it was built with AI help.

## Features

- **Approval window:** Each plan is approved locally and valid for one run within 10 minutes.
- **Local backups:** Saves server structure and affected data before changes.
- **Rollback with limits:** Can restore channels and roles, but not deleted messages.
- **Server management:** Create, edit and delete channels, categories and roles with permissions.
- **Member actions:** Edit nicknames, timeouts and role assignments for members.
- **Embeds and messages:** Send embeds or edit messages the bot sent.

## Good for

- Set up a new Discord server structure from a description
- Reorganize roles and channel permissions with a review step
- Post an announcement embed
- Keep a backup before a large server change

## Install

### Claude Code (Terminal)

```sh
claude mcp add veilleur --env DISCORD_BOT_TOKEN='<DISCORD_BOT_TOKEN>' --env DISCORD_GUILD_ID='<DISCORD_GUILD_ID>' -- uvx veilleur-discord-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "veilleur": {
      "command": "uvx",
      "args": [
        "veilleur-discord-mcp"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "<DISCORD_BOT_TOKEN>",
        "DISCORD_GUILD_ID": "<DISCORD_GUILD_ID>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "veilleur": {
      "command": "uvx",
      "args": [
        "veilleur-discord-mcp"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "<DISCORD_BOT_TOKEN>",
        "DISCORD_GUILD_ID": "<DISCORD_GUILD_ID>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "veilleur": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "veilleur-discord-mcp"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "<DISCORD_BOT_TOKEN>",
        "DISCORD_GUILD_ID": "<DISCORD_GUILD_ID>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "veilleur": {
      "command": "uvx",
      "args": [
        "veilleur-discord-mcp"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "<DISCORD_BOT_TOKEN>",
        "DISCORD_GUILD_ID": "<DISCORD_GUILD_ID>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "veilleur": {
      "command": "uvx",
      "args": [
        "veilleur-discord-mcp"
      ],
      "env": {
        "DISCORD_BOT_TOKEN": "<DISCORD_BOT_TOKEN>",
        "DISCORD_GUILD_ID": "<DISCORD_GUILD_ID>"
      }
    }
  }
}
```

## FAQ

### Does the AI change things immediately?

No. A plan must be approved in a local window before it runs.

### Is rollback perfect?

No. Recreated items get new IDs and deleted messages, attachments and reactions are not restored.

### What do I need?

Windows, Python 3.11, a Discord bot token and the server's ID.

### Where are backups kept?

In a local folder, by default %LOCALAPPDATA%/Veilleur, and they may contain private information.

### Is Veilleur free?

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

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

Run this command in your terminal: claude mcp add veilleur --env DISCORD_BOT_TOKEN='<DISCORD_BOT_TOKEN>' --env DISCORD_GUILD_ID='<DISCORD_GUILD_ID>' -- uvx veilleur-discord-mcp

### What are the best alternatives to Veilleur?

The closest alternatives to Veilleur 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/veilleur
