Wwise-MCP (Model Context Protocol for Wwise)

Wwise-MCP is a Model Context Protocol (MCP) server that enables large language models (LLMs) to interact with the Wwise Authoring application. It exposes a set of tools built on a custom Python WAAPI library, allowing MCP clients such as Claude or Cursor to automate and compose complex, multi-step Wwise workflows.

Watch the demo and installation guide on YouTube

⚠️ Experimental Notice

This project is currently in an EXPERIMENTAL state. It is still under active development and should not be used with Wwise projects intended for production at the moment. Please keep in mind:

• Breaking changes may occur without warning
• Features may be incomplete or unstable
• Documentation may be outdated or missing
• Production use is not recommended at this time

Installation

Prerequisites

• Install Claude Desktop or Cursor or any MCP compatible AI platform
• Install Wwise 2024.1+
• Install the latest Wwise-MCP.zip

Setup

• Once you have the above 3 components installed, configure your MCP Client's (i.e Claude's or Cursor's) json file to include the Wwise-MCP application.

 {
    "mcpServers":
    {
         "wwise-mcp":
         {
           "command": "C:\\Your\\PathTo\\Wwise-MCP.exe",
           "args": []
         }
    }
 }

https://github.com/user-attachments/assets/98141541-8286-4c1d-98f5-2052364bf4bb

• Refer to the setup page for detailed instructions on setting up with Claude and Cursor

⚠️ macOS Security Blocker

• On macOS, you will most likely face an error on your first launch of Wwise-MCP after setup due to macOS security.
• To bypass it, open Terminal then run chmod +x "/YourPathTo/Wwise-MCP-v1-0/macOS/Apple Silicon/Wwise-MCP"
• Make sure to configure the above command to the path where you store your version (Intel or Silicon) of Wwise-MCP
• Relaunch your MCP Client (i.e Claude) once more. It may fail again. Navigate to Privacy & Security in System Settings
• There should be a "Wwise-MCP" was blocked to protect your Mac message. Select Allow Anyway.
• Relaunch your MCP Client (i.e Claude).

Quickstart

1. Connect to your Wwise project
   Always start with a prompt akin to “Connect to my Wwise project”.
   This attaches Wwise-MCP to your currently open Wwise session.

2. Let your MCP Client (i.e Claude) “see” your project structure
   Use the “Resolve parent path” command.
   This builds an index of objects under a given Wwise path so Claude can cache and navigate your project by paths. A good place to begin is one of Wwise’s top-level roots, for example:

   • \Actor-Mixer Hierarchy, \Containers (Wwise 2025)
   • \Events
   • \Switches, \States, \Game Parameters

   Example prompt:

   Resolve all path relationships in actor mixer.

3. Before using any game object–related prompts (e.g. “Post X event on 5 new game objects and spread them around 500 units from the origin”), make sure you’ve enabled “Start Captur

... View full README on GitHub