Skip to main content

A wrapper for McDonald's servers written in Python.

Project description

Codacy Badge GitHub tag (latest SemVer) GitHub tag (latest SemVer pre-release) GitHub license Donate

PyPI PyPI - Downloads PyPI - Python Version PyPI - Wheel



mcdapi is a module written in Python that has all the utilities to communicate with McDonald's servers.


Simply run pip install mcdapi. You can upgrade with pip install -U mcdapi.

You can install a specific version with pip install mcdapi==VERSION.

Alternatively, clone this repository and run python install.

The PyPI package is at



Reverse engineering the McDonald's app

We can use a tool like JaDX to decompile the app (I prefer the latest unstable build).

You need to have the McDonald's app apk file. You can download it in two ways:

  1. Using the Yalp Store (Preferred)
  2. Using an external site like APK Mirror
  3. Using an external site like Evozi APK Downloader

Now you can open the apk with JaDX-GUI and search for the following functions


This function gets the Android ID from the device.

co.vmob.sdk.util.i.a(String str)

This function handle all the DES encryptions. Here we can obtain the DES key and how it encrypts the vmob-uid, username and password. str, String str2)

This function handle all the AES encryptions. Here we can obtain how it encrypts the plexure-api-key.

External links

I found later a guide made by someone else having a similar idea (it's on another website because the original was removed):


If this repository helped you in any way, feel free to donate here.


This repository is against McDonald's ToS.

This repository is not affiliated with McDonald's Corp in any way. "McDonald's" and "McDonald's Logo" are registered trademarks of McDonald's Corp.

Project details

Release history Release notifications

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mcdapi, version 0.1.6
Filename, size File type Python version Upload date Hashes
Filename, size mcdapi-0.1.6-py3-none-any.whl (14.6 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size mcdapi-0.1.6.tar.gz (7.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page