Build a Discord Bot with Python and Flask

In this tutorial, learn how to use Python to interact with the Discord API—and build a bot using Flask.

Discord is a platform that enables people to talk over voice, video, and text, as well as hang out with their friends and communities. Discord provides a way to section different groups of people with Server/Guild.

In this article, you will learn how to use some features provided by Discord API. We will begin by explaining how to set up Discord OAuth2 for authentication, followed by building a simple discord bot and attaching it to some servers, and finally, displaying the servers where the bot is attached on the frontend.

When working with Discord, a lot of functionality will need to be handled asynchronously because Discord uses WebSockets to build real-time communication between the Discord API and the application. With that said, we will have to use a version of Flask that handle asynchronous requests perfectly Quart.

You can find the full project on GitHub.


  • Basic knowledge of Python and Flask.
  • Python installed.
  • Discord account and about five servers created.

Authenticate Discord with OAuth2

Later in this article, we will be building something like a dashboard where you can see all the servers that have your bot attached to it. You may not want everyone to be able to access that page, so you can use the OAuth2 system provided by Discord.

To do this, go to the Discord developer portal, and ***on the Discord developer portal page, click the “New Application*” button in the top right corner. Then, fill in the “Name” field and submit.

Next, click the OAuth2 dropdown and then click the Add Redirect button. This is where you will add the URL that will handle the redirect after authentication. The URL we will be using for the redirect is Also, take note of the CLIENT ID and CLIENT SECRET because we will need them in the code.

Set OAuth2 callback URL Set OAuth2 callback URL

On the OAuth2 dropdown, click the URL Generator tab and select the scope that you see on the image below. Then, copy the URL generated. This URL will be used to connect the bot to the server.

URL generator page URL generator page

Open the URL on the browser, select the server you want to connect the bot to it, and submit all the redirects.

Now, let’s install the dependencies with the following command.

pip install quart quart-discord discord-ext-ipc discord

Building the Authentication System

First, create a new file with name and paste the following code. The code below is initializing the credentials and routes required to authenticate with Discord.

from quart import Quart, render_template, redirect, url_for
from quart_discord import DiscordOAuth2Session
import os

] = "1"  # this is required because OAuth 2 utilizes https.

app = Quart(__name__)

app.config["SECRET_KEY"] = "test123"

app.config["DISCORD_CLIENT_ID"] = 969522874446671953  # Discord client ID.
] = "dfp9GSgUHqvIMBSEIsrG9DW1XMnJskhl"  # Discord client secret.
] = ""  # URL to your callback endpoint.

discord = DiscordOAuth2Session(app) #handle session for authentication

async def home():
    return await render_template("home.html", authorized=await discord.authorized)

async def login():
    return await discord.create_session() # handles session creation for authentication

async def callback():
        await discord.callback()
    except Exception:

    return redirect(url_for("dashboard")) #dashboard function will be  created later in the a

Remember the credentials I told you to take note of earlier? You will need to input them in the code above. If you are building a real-world project, you will need to make sure to keep those credentials secure.

If you notice in the code above, we used a file home.html; this is the page that the will handle the authentication button. In the same folder where is located, create a new directory and file templates/home.html and paste the code below.

<!DOCTYPE html>
    <title>Home Page</title>
<h1>Welcome to the Home page!</h1>

Click here to login:
<a href="/login"><button>Login with discord</button></a>


Creating the Discord Bot

In this section, we will be creating a simple bot that says, “Hello There!”, when it is pinged. To accomplish this, we will use two tools that we installed earlier: discord-ext-ipc and discord. discord is a Discord library for Python, and discord-ext-ipc provides a server for bot services.

Start by creating a file named and paste the following code. The code below sends "Hello there!" anytime it is pinged.

import discord
from discord.ext import commands, ipc

class MyBot(commands.Bot):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

        self.ipc = ipc.Server(self, secret_key="this_is_secret") #used tonnect ipc server to other servers

    async def on_ready(self):
        """Called upon the READY event"""
        print("Bot is ready.")

    async def on_ipc_ready(self):
        """Called upon the IPC Server being ready"""
        print("Ipc server is ready.")

    async def on_ipc_error(self, endpoint, error):
        """Called upon an error being raised within an IPC route"""
        print(endpoint, "raised", error)

my_bot = MyBot(command_prefix="$", intents=discord.Intents.default()) #prefix to ping the bot

async def hello(ctx): 
    await ctx.send("Hello there!") # response from the bot when you send $hello


For the bot to work, you need to get the bot token from the Discord developer portal, in the Bot tab.

Get Discord bot token Get Discord bot token

Building the Dashboard

To build the dashboard, we need write functions in to get the number of guilds where the bot is present and the guild IDs of the guilds where the bot is present. We need the guild IDs for the bot so that we can match it with the list of all user guilds that we get in the application (, and then display the guild’s details where they match.

You can do this by pasting the following code above my_bot.ipc.start() in your file.

async def get_guild_count(data):
    return len(my_bot.guilds)  # returns the len of the guilds to the client

async def get_guild_ids(data):
    final = []
    for guild in my_bot.guilds:
    return final  # returns the guild ids where the bot is

Now we need to write the function for the dashboard in the file. Paste the following code, below in callback().

async def dashboard():
    guild_count = await ipc_client.request("get_guild_count") # get func we created aearlier for guild count
    guild_ids = await ipc_client.request("get_guild_ids") # get func we created aearlier for guild IDs

        user_guilds = await discord.fetch_guilds() # fetch data for user's guilds
        user = await discord.fetch_user() #fetch data for user
        return redirect(url_for("login")) # redirect to login page if user is not logged in

    same_guilds = []

    for guild in user_guilds:
        if in guild_ids:

    return await render_template(
        "dashboard.html", guild_count=guild_count, matching=same_guilds, user=user

if __name__ == "__main__":

Then add the code below to the top of the file.

from discord.ext import ipc 

ipc_client = ipc.Client(
)  # secret_key must be the same as your IPC server

You may have noticed in dashboard() that we are rendering a template (dashboard.html) we have not created.

Create a new file with the name dashboard.html in templates/ and paste the following code.

<!DOCTYPE html>
  <h3>Hello, {{}}! Please select a server to get started</h3>

<h2> The Bot is in: {{guild_count}} servers </h2>

<h3> Bot's guilds </h3>

{% for guild in matching %}
<img src="{{guild.icon_url}}"  />
  <li>{{ }}</li>
{% endfor %}



To begin, let’s start the server for the bot and the application. You can start the server for the bot by running python, and you can start the app on another command-line window with python Now go to Discord and select one of the guilds/servers to which you attached the bot, and you will notice on the top right that your bot is active. Ping the bot by texting “$hello”, and you should get “Hello There!” as the response.

Output from the whole code Output from the whole code

You can test the application by going to localhost for Flask; hit the login button to log in, and then you will be redirected to the dashboard.

Dashboard display Dashboard display


In this article, you’ve learned how to use each feature provided by Discord API. First, we learned how to set up Discord OAuth2 for authentication. Then, we built a simple discord bot and attached it to some servers/guilds. Finally, we displayed the servers where we attached the bot on the frontend.

You may have noticed that in the tutorial, I didn’t pay attention to the design of the application. This could be where you can improve from where I left off. Of course, you can always improve on the complexity of the bot as needed.

Finally, please remember to always secure your Discord credentials.

What to do next:
  1. Try Honeybadger for FREE
    Honeybadger helps you find and fix errors before your users can even report them. Get set up in minutes and check monitoring off your to-do list.
    Start free trial
    Easy 5-minute setup — No credit card required
  2. Get the Honeybadger newsletter
    Each month we share news, best practices, and stories from the DevOps & monitoring community—exclusively for developers like you.
    author photo

    Muhammed Ali

    Muhammed is a Software Developer with a passion for technical writing and open source contribution. His areas of expertise are full-stack web development and DevOps.

    More articles by Muhammed Ali
    Stop wasting time manually checking logs for errors!

    Try the only application health monitoring tool that allows you to track application errors, uptime, and cron jobs in one simple platform.

    • Know when critical errors occur, and which customers are affected.
    • Respond instantly when your systems go down.
    • Improve the health of your systems over time.
    • Fix problems before your customers can report them!

    As developers ourselves, we hated wasting time tracking down errors—so we built the system we always wanted.

    Honeybadger tracks everything you need and nothing you don't, creating one simple solution to keep your application running and error free so you can do what you do best—release new code. Try it free and see for yourself.

    Start free trial
    Simple 5-minute setup — No credit card required

    Learn more

    "We've looked at a lot of error management systems. Honeybadger is head and shoulders above the rest and somehow gets better with every new release."
    — Michael Smith, Cofounder & CTO of YvesBlue

    Honeybadger is trusted by top companies like:

    “Everyone is in love with Honeybadger ... the UI is spot on.”
    Molly Struve, Sr. Site Reliability Engineer, Netflix
    Start free trial
    Are you using Sentry, Rollbar, Bugsnag, or Airbrake for your monitoring? Honeybadger includes error tracking with a whole suite of amazing monitoring tools — all for probably less than you're paying now. Discover why so many companies are switching to Honeybadger here.
    Start free trial
    Stop digging through chat logs to find the bug-fix someone mentioned last month. Honeybadger's built-in issue tracker keeps discussion central to each error, so that if it pops up again you'll be able to pick up right where you left off.
    Start free trial