Discord

This MCP server automates Discord server setup on macOS using AppleScript/JXA, enabling you to create servers, channels, categories, roles, and adjust server settings through AI assistants. It streamlines complex Discord configurations and templates, helping you deploy consistent communities quickly.

How to use

You interact with the MCP server through an MCP client. Start the MCP client and issue natural language requests such as creating a new server from a template, adding channels and categories, configuring roles, or updating server settings. The server interprets your instructions and performs the corresponding Discord automations via AppleScript/JXA, keeping Discord visible and focused during operations.

How to install

Prerequisites: you must be on macOS and have Node.js 18.0.0 or higher installed. You also need the Discord Desktop App (not the web version) and the application running with Accessibility permissions enabled.

Step 1: Install the MCP server package globally

npm install -g discord-setup-mcp

Step 2: Build the project from source if you’re working from a local copy

git clone https://github.com/yourusername/discord-setup-mcp.git
cd discord-setup-mcp
npm install
npm run build

Configuration and usage notes

Configure how the MCP server runs from your MCP client. You can use a local node process or a globally installed CLI to start the server.

# Local stdio configuration example (Node process)
{
  "mcpServers": {
    "discord-setup": {
      "command": "node",
      "args": ["/path/to/discord-setup-mcp/dist/index.js"]
    }
  }
}

Or, if you install the MCP server globally, you can run the CLI directly.

{
  "mcpServers": {
    "discord-setup": {
      "command": "discord-setup-mcp"
    }
  }
}

Security and prerequisites for macOS automation

Grant Accessibility permissions to the application running this MCP server so it can automate Discord via AppleScript. This is required for the automation to interact with the Discord desktop app.

Configuration details

Discord automation relies on the Discord Desktop App being visible and the Discord window being active during automation steps.

The server supports templates, channels, categories, roles, and server settings with pre-built templates to speed setup.

Troubleshooting

If automation fails, ensure Discord is running, logged in, and visible. If you encounter element-not-found errors, bring Discord into foreground and retry after a moment.

Development

Build-focused commands and scripts live in a typical TypeScript project setup. You can run the development workflow to watch files and rebuild on changes.

Known limitations

macOS-only automation, desktop app required, Discord must be visible on screen, UI updates can affect automation, operations target the currently active server, and rate limits may require built-in delays.

Available tools

check_discord_status

Check if Discord is running and focused, ensuring a safe start for automation.

create_server

Create a new Discord server with an optional pre-defined template.

focus_discord

Bring the Discord window to the foreground to ensure the correct UI is targeted during automation.

create_category

Create a new category to organize channels within a server.

create_channel

Create a channel of type text, voice, announcement, stage, or forum in a server.

edit_channel

Modify channel properties such as name, topic, and slowmode.

delete_channel

Delete a channel with appropriate confirmation handling.

create_role

Create a new role with color, hoist, and permission settings.

edit_role

Update an existing role's properties and permissions.

delete_role

Remove a role from the server.

reorder_roles

Change the hierarchy order of roles in the server.

open_server_settings

Open the server settings panel for configuration.

set_verification_level

Set the server member verification level.

set_content_filter

Configure the explicit content scanning behavior.

set_default_notifications

Define default notification preferences for new members.

list_templates

List all available server templates.

preview_template

Preview the details of a selected template.

apply_template

Apply a template to create a server structure.