Skip to main content

Discord Setup

Connecting MuteDeck to Discord allows you to control voice channel sessions and visualize your meeting status. This integration uses a personal Discord app that you create, which securely connects MuteDeck to your Discord account.

Why do I need my own Discord app?​

Due to Discord's security policies, third-party applications like MuteDeck can't use shared Discord credentials anymore. This means you'll need to create your own personal Discord "app" to enable the integration. Don't worry - it's completely free and only takes a few minutes! We hope we can make this process easier in the future, but for now, this is the only way to connect MuteDeck to Discord.

Think of it like getting your own personal key to connect MuteDeck to your Discord account. This approach is actually more secure because only you have access to your credentials.

What you'll need​

  • A Discord account (the same one you use daily)
  • About 5 minutes of your time
  • Access to a web browser

Step-by-step guide​

Step 1: Access the Discord Developer Portal​

  1. Open your web browser and go to https://discord.com/developers/applications
  2. Sign in with your regular Discord account (the same one you use for chatting)
  3. You'll see a page titled "My Applications" - this is Discord's developer dashboard

Don't worry about the word "developer" - you're not actually developing anything! This is just where Discord lets users create personal apps.

Step 2: Create your MuteDeck app​

  1. Click the "New Application" button (usually blue, in the top-right area)
  2. Give your app a name - we suggest "MuteDeck Integration" or something similar
  3. Read and accept Discord's Terms of Service by checking the box
  4. Click "Create"

Congratulations! You've just created your Discord app. You'll now see a dashboard with various settings.

Step 3: Get your app ID​

  1. You should now be on the "General Information" tab of your new app
  2. Look for a section called "Application ID"
  3. Click the "Copy" button next to the long number - this is your App ID
  4. Paste this somewhere safe (like a notes app) - you'll need it in MuteDeck later

The App ID is like your app's unique identifier - it's safe to share and doesn't give anyone access to your account.

Step 4: Get your app secret​

  1. In the left navigation menu, click on "OAuth2"
  2. Look for the "Client information" section
  3. Click "Reset Secret" (or "Copy" if you see a secret already)
  4. Discord will ask you to confirm - click "Yes, do it!"
  5. Immediately copy the secret that appears and save it safely
  6. ⚠️ Important: You can only see this secret once! If you lose it, you'll need to reset it again

The Client Secret is like your app's password - keep it private and never share it publicly.

Step 5: Set up OAuth2 settings​

  1. Still on the "OAuth2" tab, scroll down to the "Redirects" section
  2. Click "Add Redirect"
  3. Enter: http://localhost:3491/discord/callback (tip: copy and paste this exactly)
  4. Click "Save Changes" at the bottom

This tells Discord where to send you back after authorization - in this case, back to MuteDeck on your computer.

Using your credentials in MuteDeck​

Now that you have your App ID and Client Secret:

  1. Open MuteDeck and go to Settings
  2. Enable Discord integration
  3. Click "Setup Discord App"
  4. Paste your App ID into the first field
  5. Paste your Client Secret into the second field
  6. Click "Start Pairing"
  7. Follow the authorization process in your Discord app
    • Click "Authorize" when asked to allow MuteDeck access
  8. MuteDeck will confirm the pairing was successful!

Troubleshooting​

"Invalid Client" error​

  • Double-check that you copied the App ID and Client Secret correctly
  • Make sure there are no extra spaces when pasting

Authorization doesn't work​

  • Verify that your redirect URL is exactly: http://localhost:3491/discord/callback
  • Make sure you saved changes in the Discord Developer Portal

Can't find the Developer Portal​

  • Make sure you're logged into Discord in your browser
  • Try using an incognito/private browsing window if you have issues

Still having issues?​

  • You can always delete your app and create a new one if something goes wrong
  • Each Discord account can create multiple apps, so don't worry about "breaking" anything

Security notes​

  • Your App ID and Client Secret are personal to you - don't share them with others
  • Only MuteDeck should use these credentials - don't enter them into other applications
  • You can revoke access anytime by deleting the app in the Discord Developer Portal
  • This doesn't give MuteDeck any special access to your Discord account beyond what you explicitly authorize

What's next?​

Once you've completed the pairing process, MuteDeck will be able to:

  • Show your meeting status in Discord
  • Update your Discord status when you're in meetings
  • Display rich presence information to your Discord friends

Your Discord app will remain active and continue working with MuteDeck unless you delete it from the Developer Portal.