Skip to main content
The Harmonica MCP server lets AI agents create and interact with deliberation sessions. Available on npm.

​
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

Add the server to your AI tool’s MCP config: 
{
  "mcpServers": {
    "harmonica": {
      "command": "npx",
      "args": ["-y", "harmonica-mcp"],
      "env": {
        "HARMONICA_API_KEY": "hm_live_your_key_here"
      }
    }
  }
}

​
Available tools

ToolDescription
create_sessionCreate a new deliberation session and get a shareable join URL
list_sessionsList your sessions (filter by status, search by keywords)
get_sessionGet full details of a session
get_responsesGet participant responses
get_summaryGet the AI-generated summary
search_sessionsSearch sessions by topic or goal

​
Example prompts

Once connected, try these prompts with your AI agent:
  • “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”

​
Claude Code slash command

If you use Claude Code, you can also install the harmonica-chat slash command for designing, creating, and managing sessions: 
curl -fsSL https://raw.githubusercontent.com/harmonicabot/harmonica-chat/main/install.sh | bash
Then run /harmonica-chat for guided session design, or /harmonica-chat "Topic" for quick creation.

​
Environment variables

VariableRequiredDefault
HARMONICA_API_KEYYes—
HARMONICA_API_URLNohttps://app.harmonica.chat