Clear github hidden notifications

clear.py

import urllib.request
import json

# ⚠️ Replace this with your GitHub personal access token (must include notifications scope)
GITHUB_TOKEN = "your_personal_access_token_here"

BASE_URL = "https://api.github.com"
HEADERS = {
    "Authorization": f"Bearer {GITHUB_TOKEN}",
    "Accept": "application/vnd.github+json",
    "User-Agent": "Python-urllib"  # GitHub requires a User-Agent header
}

def api_request(url, method="GET"):
    """Make an HTTP request to the GitHub API and return (status, body)."""
    req = urllib.request.Request(url, method=method, headers=HEADERS)
    try:
        with urllib.request.urlopen(req) as resp:
            status = resp.getcode()
            body = resp.read().decode("utf-8")
            return status, body
    except urllib.error.HTTPError as e:
        return e.code, e.read().decode("utf-8")
    except urllib.error.URLError as e:
        return None, str(e)

def list_notifications():
    """Fetch notifications from GitHub."""
    url = f"{BASE_URL}/notifications"
    status, body = api_request(url)
    if status != 200:
        print(f"Error fetching notifications: {status}")
        print(body)
        return []
    return json.loads(body)

def mark_thread_done(thread_id):
    """Mark a notification thread as Done (archive it)."""
    url = f"{BASE_URL}/notifications/threads/{thread_id}"
    status, body = api_request(url, method="DELETE")
    if status == 204:
        print(f"✅ Thread {thread_id} marked as Done")
    else:
        print(f"❌ Failed to mark thread {thread_id} as Done: {status}")
        print(body)

def main():
    notifications = list_notifications()
    if not notifications:
        print("No notifications found or failed to fetch notifications.")
        return

    print("\n📬 Current notifications:")
    for idx, n in enumerate(notifications, start=1):
        repo = n["repository"]["full_name"]
        title = n["subject"]["title"]
        notif_type = n["subject"]["type"]
        thread_id = n["id"]
        unread = n.get("unread", False)
        print(f"{idx}. [{repo}] ({notif_type}) {title} → thread_id={thread_id} unread={unread}")

    while True:
        inp = input("\nEnter notification numbers to mark as Done (q to quit): ").strip()
        if inp.lower() == 'q':
            break

        # Support both spaces and commas as separators
        parts = [p for p in inp.replace(',', ' ').split() if p.isdigit()]
        if not parts:
            print("⚠️ Invalid input. Please enter one or more numbers separated by space or comma.")
            continue

        indices = [int(p) for p in parts if 1 <= int(p) <= len(notifications)]
        if not indices:
            print("⚠️ No valid numbers found in input.")
            continue

        for idx in indices:
            selected = notifications[idx - 1]
            mark_thread_done(selected["id"])

if __name__ == "__main__":
    main()

Step 1: Generate a GitHub token for notifications

1. Go to GitHub Personal Access Tokens (classic).

2. Enter any token name of your choice.

3. Check the notifications permission.

4. Click Generate token.

5. Copy your token (looks like ghp_xxxxxxxxxxxxxxxxxxxxxx) and replace the placeholder
   your_personal_access_token_here in the Python script.

---

Step 2: Run the script

Execute the script in your terminal:

python clear.py

• The script will list all unread notifications.
• Enter the numbers of the notifications you want to delete (separated by spaces).
  Example: 5 6 7 8
• Press Enter to confirm.

---

Example: Before & After

Before:

After:

Related discussion https://github.com/orgs/community/discussions/174283#discussioncomment-14505163

Thanks!

Working solution. Thank you!

Great work! Thanks

Thank you very much!

Thank you!

Thank you very much!

非常感谢，终于没了

Thank you very much!