🎓 Udemy MCP Server (Python)

A Model Context Protocol (MCP) server that connects AI assistants — such as Claude Desktop, Antigravity, Cursor, and others — to the Udemy platform.

With your regular Udemy account you get access to both public features (searching courses, viewing curricula, reading reviews) and private features (your enrolled courses and profile info).

✨ Features

• 🔍 Search courses — by keyword, category, price, level, language, and more

• 📖 View course details — descriptions, learning goals, prerequisites, ratings

• 📚 Browse curricula — lecture outlines, durations, and free preview flags

• ⭐ Read reviews — student ratings and written feedback

• 🏷️ List categories — discover all top-level Udemy categories

• 👤 View your profile — display name, title, and avatar

• 📦 List enrolled courses — see everything you're currently learning

Related MCP server: Coursera MCP

📁 Project Structure

UdemyMcpPython/
├── main.py              # Entry point — starts the MCP server
├── requirements.txt     # Python dependencies
├── .env.example         # Template for environment variables
├── .gitignore
├── README.md
└── src/
    ├── __init__.py      # Package marker
    ├── server.py        # MCP tool definitions (7 tools)
    └── client.py        # Async Udemy API client (httpx)

🚀 Getting Started

Prerequisites

• Python 3.10+

• A Udemy account (free or paid)

1. Clone the repository

git clone https://github.com/<your-username>/UdemyMcpPython.git
cd UdemyMcpPython

2. Create a virtual environment & install dependencies

python -m venv .venv
source .venv/bin/activate        # macOS / Linux
# .venv\Scripts\activate         # Windows

pip install -r requirements.txt

3. Configure environment variables

cp .env.example .env

Open .env and fill in your credentials (see Authentication below).

4. Run the server

python main.py

🔑 Authentication

The server supports two authentication methods. You only need to set up one.

Method 1: Access Token (⭐ Recommended)

Use the session cookie from your regular Udemy login — gives access to all tools including private ones.

1. Log into udemy.com in your browser.

2. Open Developer Tools (F12 or Cmd + Option + I on Mac / Ctrl + Shift + I on Windows).

3. Navigate to Application → Cookies → https://www.udemy.com (in Firefox: Storage → Cookies).

4. Find the cookie named access_token and copy its value.

5. Paste it into your .env file:

UDEMY_ACCESS_TOKEN=your_access_token_here

Method 2: API Client Credentials

If you have Udemy Developer / Affiliate API keys:

1. Go to Udemy API Clients.

2. Copy your Client ID and Client Secret.

3. Add them to .env:

UDEMY_CLIENT_ID=your_client_id
UDEMY_CLIENT_SECRET=your_client_secret

🛠️ Available MCP Tools

⚙️ MCP Client Configuration

Add the following to your MCP client's configuration file (mcp_config.json, claude_desktop_config.json, etc.):

{
  "mcpServers": {
    "udemy": {
      "command": "/absolute/path/to/UdemyMcpPython/.venv/bin/python",
      "args": ["/absolute/path/to/UdemyMcpPython/main.py"],
      "env": {
        "UDEMY_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

🧰 Tech Stack

📄 License

This project is open-source. Feel free to use and modify it for your own purposes.