Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To connect a MySQL GUI client to a MySQL server running on the same Apple Silicon Mac, choose the client’s MySQL TCP/IP connection, enter 127.0.0.1 and the server’s listening port (3306 by default), then provide a MySQL account’s credentials. First make sure the server—not just the GUI client—is installed and running.

What you need before connecting

A GUI client is a separate program from MySQL Server. Installing Workbench or DBeaver does not itself install or start the database server. The connection succeeds only when a running server is listening at the address and port you enter and the account can authenticate.

  • A running MySQL Server instance on the Mac.
  • The host address and TCP/IP port for that instance. MySQL’s documented default TCP/IP port is 3306, but an installation can use a different port.
  • A valid MySQL username and password for the server.

Connect with MySQL Workbench

  1. Confirm the server is running. Identify the installation you intend to use if you have more than one MySQL installation on the Mac.
  2. Add a connection in Workbench. Choose the standard Standard (TCP/IP) method.
  3. Enter the endpoint and account. Set Hostname to 127.0.0.1, Port to the server’s actual listening port (3306 is the default), and Username to an account that can log in. Enter or save the password using the client’s password controls. You can leave the default schema blank while setting up the connection.
  4. Test before saving. Select Test Connection. If the test succeeds, save the connection and open it.

Workbench describes this method as: “This connection method enables MySQL Workbench to connect to MySQL Server using TCP/IP.” See the Workbench Standard TCP/IP Connection Method documentation for the connection settings.

Connect with DBeaver

DBeaver Community is a multi-database alternative that supports MySQL. Its download page lists an Apple Silicon macOS build and describes Community as free and open source. Create a MySQL connection, then use the same local endpoint, listening port, username, and password described above. Check the DBeaver download page for the current macOS build options.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Sale
Apple 2026 MacBook Air 13-inch Laptop with M5 chip: Built for AI, 13.6-inch Liquid Retina Display, 16GB Unified Memory, 512GB SSD, 12MP Center Stage Camera, Touch ID, Wi-Fi 7; Midnight
  • BUILT FOR COLLEGE. AND BEYOND — MacBook Air with the M5 chip packs blazing speed and powerful AI capabilities into an incredibly portable design. And with up to 18 hours of battery life,* this thin and light powerhouse is ready to take on almost any major, just about anywhere.
  • TEAR THROUGH TOUGH ASSIGNMENTS — With its faster CPU and unified memory, the M5 chip delivers even more performance and fluidity across apps, making multitasking and creative workflows smooth and responsive. A powerful Neural Engine and next-generation GPU with Neural Accelerators give you a powerful platform for AI.
  • MAKE QUICK WORK OF YOUR TO-DO LIST — Apple Intelligence helps you write, express yourself, and get things done effortlessly — whether it’s for school or everyday life. With groundbreaking privacy protections, it gives you peace of mind that no one else can access your data — not even Apple.*
  • UP TO 18 HOURS OF BATTERY LIFE — MacBook Air delivers incredible battery life with amazing performance, so you can power through a full day of classes without worrying about plugging in.
  • A BRILLIANT 13.6-INCH DISPLAY* — The gorgeous Liquid Retina display on MacBook Air supports 1 billion colors, making photos and videos pop with rich contrast and sharp detail, and text appears supercrisp. So everything — from class presentations to movies to games — looks truly stunning.

Start a Homebrew MySQL server

If you installed MySQL with Homebrew, the formula documents these commands:

  1. Install the server: brew install mysql
  2. Start it as a Homebrew service: brew services start mysql
  3. Use your GUI client to connect to 127.0.0.1 on the port that instance listens on, with a MySQL account valid for it.

The Homebrew MySQL formula says the server is configured to allow connections from localhost by default. Formula details and service behavior can change, so check the current formula if the commands or setup differ on your Mac.

Why use 127.0.0.1 instead of localhost?

For a GUI’s explicit TCP/IP connection, 127.0.0.1 identifies the IPv4 loopback address and makes the intended transport clear. In Unix-like environments, MySQL command-line clients treat localhost specially and commonly use a Unix socket rather than TCP/IP; supplying a port alone does not necessarily switch that behavior. Use 127.0.0.1 or explicitly request TCP/IP when diagnosing with the command line. See the MySQL connection documentation.

There is also an account-matching consequence: Workbench notes that localhost may resolve to either 127.0.0.1 or ::1 (IPv6 loopback). MySQL account grants can distinguish these host addresses, so a connection that reaches the server can still be denied if the account’s host grant does not match the address used.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Apple 2020 Mac Mini with Apple M1 Chip, 16GB RAM, 1TB SSD Storage, Silver (Renewed)
  • BTO Mac Mini Desktop Computer - Power Cord - Apple 1 Year Limited Warranty with 90 Day Free Technical Support
  • Apple M1 chip with 8-core CPU and 8-core GPU
  • 16-core Neural Engine
  • 16GB unified memory
  • 1TB SSD storage
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot a failed connection

Connection refused or timeout

  • Verify the intended MySQL server process is running.
  • Confirm the GUI’s host and port match the address and port where that server listens. Do not assume 3306 if the instance is configured differently.
  • Check that the client is using TCP/IP and that the server accepts local connections.

Socket error or a port that seems ignored

This commonly arises when diagnosing with a command-line client using localhost, because it may choose a Unix socket instead of TCP. Try 127.0.0.1 or explicitly select TCP/IP, then verify the port for the server instance.

Access denied

  • Check the username and password for the server you are reaching.
  • Check the MySQL account’s host grants against the address used. A grant matching localhost, 127.0.0.1, or ::1 may not be interchangeable.

The GUI connects to the wrong server or port

Look for multiple MySQL installations or running instances and determine which one owns the listening port. Oracle’s macOS installation notes explain that an installer-managed installation and a Homebrew installation can coexist and may contend for default ports. Keep their locations and startup methods distinct, and stop the unintended instance if it conflicts. See Oracle’s MySQL macOS installation notes.

Choose a client for your workflow

Client Useful when you want Apple Silicon availability in cited sources
MySQL Workbench MySQL-focused visual modeling, SQL development, and administration Official product page lists Mac availability; check the current download and compatibility details for your macOS release.
DBeaver Community A multi-database interface that also supports MySQL DBeaver’s download page lists an Apple Silicon macOS build.

Neither client is universally best. Choose based on whether you need MySQL-specific modeling and administration or prefer one interface for multiple database systems. For either client, verify that the current build supports your macOS version and that its connection settings match the server you actually run. See the MySQL Workbench product page and DBeaver downloads.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.