MCP Server

​

Setup

​

1. Get an API key

1. Sign up for Harmonica if you haven’t already (free)
2. Go to your Profile > API Keys > Generate API Key
3. Copy your hm_live_... key — it’s only shown once

​

2. Configure your AI tool

{
  "mcpServers": {
    "harmonica": {
      "command": "npx",
      "args": ["-y", "harmonica-mcp"],
      "env": {
        "HARMONICA_API_KEY": "hm_live_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "harmonica": {
      "command": "npx",
      "args": ["-y", "harmonica-mcp"],
      "env": {
        "HARMONICA_API_KEY": "hm_live_your_key_here"
      }
    }
  }
}

{
  "mcpServers": {
    "harmonica": {
      "command": "npx",
      "args": ["-y", "harmonica-mcp"],
      "env": {
        "HARMONICA_API_KEY": "hm_live_your_key_here"
      }
    }
  }
}

​

Available tools

​

Example prompts

• “Create a Harmonica session about team retrospective with the goal of reviewing Q1”
• “List my active Harmonica sessions”
• “Show me the summary for session [id]”
• “What did participants say in the remote work session?”
• “Search my sessions about governance”
• “Show me the facilitation prompt for session [id]”
• “Update the prompt for session [id] to be more concise and avoid excessive praise”

​

Claude Code slash command

curl -fsSL https://raw.githubusercontent.com/harmonicabot/harmonica-chat/main/install.sh | bash

​

Environment variables