# PlayByKey Music Theory

> PlayByKey Music Theory is an open-source MCP server for design and media. Chords, scales, progressions, transposition, and MIDI tools for music theory AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/digitalbrewllc/playbykey-dev-tools/tree/HEAD/packages/theory-mcp
- **MCP Registry name:** com.playbykey/theory-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-13

## About

Chords, scales, progressions, transposition, and MIDI tools for music theory AI agents.

## Install

### Claude Code (Terminal)

```sh
claude mcp add theory-mcp -- npx -y @playbykey/theory-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "theory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@playbykey/theory-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "theory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@playbykey/theory-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "theory-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@playbykey/theory-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "theory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@playbykey/theory-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "theory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@playbykey/theory-mcp"
      ]
    }
  }
}
```

## FAQ

### Is PlayByKey Music Theory free?

Yes. PlayByKey Music Theory is open source, so you can use and self-host it for free.

### How do I add PlayByKey Music Theory to Claude Code?

Run this command in your terminal: claude mcp add theory-mcp -- npx -y @playbykey/theory-mcp

### What are the best alternatives to PlayByKey Music Theory?

The closest alternatives to PlayByKey Music Theory are Clef Music Tools, Music Studio, Songbrain, GrooveSheet and Jam Jam.

## Where this comes from

- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Clef Music Tools](https://ai-powered.com/mcp/clef-music-tools): Clef Music Tools is a freemium MCP server for design and media.
- [Music Studio](https://ai-powered.com/mcp/music-studio): Music Studio is a free MCP server for design and media.
- [Songbrain](https://ai-powered.com/mcp/songbrain): Songbrain is a freemium MCP server for design and media.
- [GrooveSheet](https://ai-powered.com/mcp/groovesheet): GrooveSheet is a freemium MCP server for design and media.
- [Jam Jam](https://ai-powered.com/mcp/jam-jam): Jam Jam is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/playbykey-music-theory
