About Harmonica MCP
Harmonica MCP is an MCP server in the Communication category: mCP server for Harmonica deliberation sessions — create, query, and analyze sessions from any AI agent.
Install
git clone https://github.com/harmonicabot/harmonica-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (23)
close_sessionEnd a session without deleting its participant threads, messages, summaries, or other data
Parameters not published.
create_projectCreate a project (workspace) to group related sessions
Parameters not published.
create_sessionCreate a new deliberation session and get a shareable join URL (optional: `questions`, `project_id` to file it under a project)
Parameters not published.
create_unconference_topicCreate a draft topic in an Unconference project and mirror it to the connected brain repository (editor access)
Parameters not published.
delete_projectSoft-delete a project; its sessions are left intact (owner access)
Parameters not published.
get_meeting_restrictionsGet effective processing restrictions, pending candidates, and history for an owned meeting
Parameters not published.
get_projectGet a project by id, with the ids of its linked sessions
Parameters not published.
get_questionsGet pre-session questions (data collection form)
Parameters not published.
get_responsesGet participant responses
Parameters not published.
get_sessionGet full session details (includes facilitation prompt)
Parameters not published.
Show all 23 tools
get_summaryGet AI-generated summary
Parameters not published.
get_transcriptGet the persisted transcript and speaker turns for a personal calendar meeting
Parameters not published.
install_method_specInstall an OFL method spec (method.md) as a runnable chain template
Parameters not published.
list_meetingsList personal calendar meetings captured by the Harmonica notetaker
Parameters not published.
list_projectsList the projects (workspaces) you have access to
Parameters not published.
list_sessionsList your deliberation sessions (filter by status, search)
Parameters not published.
list_telegram_groupsList Telegram groups registered to the user's account (no parameters)
Parameters not published.
publish_sensemaking_topicPublish a project as a public sensemaking topic (`/explore` + `/t/[slug]`)
Parameters not published.
reopen_sessionReopen a completed session so participants can join again
Parameters not published.
search_sessionsSearch by topic or goal
Parameters not published.
update_meeting_restrictionsSet restrictions or review a pending transcript-derived candidate for an owned meeting
Parameters not published.
update_projectRename a project or update its description (editor access)
Parameters not published.
update_sessionUpdate session metadata (topic, goal, context, critical, prompt; `project_id` to move it into a project or `null` to detach)
Parameters not published.
Ask AI
Ask AI about Harmonica MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
Harmonica MCP Server
MCP server enabling AI agents to create and query Harmonica deliberation sessions.
Harmonica is a structured deliberation platform where groups coordinate through AI-facilitated async conversations. Create a session with a topic and goal, share a link with participants, and each person has a private 1:1 conversation with an AI facilitator. Responses are synthesized into actionable insights. Learn more.
Quick Start
1. Get an API key
- Sign up for Harmonica (free)
- Go to Profile > API Keys > Generate API Key
- Copy your
hm_live_...key — it's only shown once
2. Configure your MCP client
Add to your MCP client config (e.g. Claude Code, Cursor, Windsurf):
{
"mcpServers": {
"harmonica": {
"command": "npx",
"args": ["-y", "harmonica-mcp"],
"env": {
"HARMONICA_API_KEY": "hm_live_your_key_here"
}
}
}
}
3. Start a deliberation
Ask your AI agent to create a session:
Create a Harmonica session about "Team Retrospective" with the goal "Review Q1 and identify improvements"
Share the join URL with participants. Once they've responded, use get_responses and get_summary to see the results.
Tools
| Tool | Description |
|---|---|
create_session |
Create a new deliberation session and get a shareable join URL (optional: questions) |
update_session |
Update session metadata (topic, goal, context, critical, prompt) |
list_sessions |
List your deliberation sessions (filter by status, search) |
get_session |
Get full session details (includes facilitation prompt) |
get_questions |
Get pre-session questions (data collection form) |
get_responses |
Get participant responses |
get_summary |
Get AI-generated summary |
search_sessions |
Search by topic or goal |
list_telegram_groups |
List Telegram groups registered to the user's account (no parameters) |
From Source
git clone https://github.com/harmonicabot/harmonica-mcp.git
cd harmonica-mcp
npm install && npm run build
Then use node /path/to/harmonica-mcp/dist/index.js instead of npx -y harmonica-mcp in your config.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
HARMONICA_API_KEY |
Yes | — | Your Harmonica API key |
HARMONICA_API_URL |
No | https://app.harmonica.chat |
API base URL |
Roadmap
- One-command install via
npx add-mcp(auto-detects Claude Code, Cursor, Windsurf) - HTTP transport — zero-install setup, just add a URL
- Inbound context — feed external data into sessions via MCP
- Session templates discovery tool
- TypeScript and Python client SDKs
See Also
- harmonica-chat — Conversational Harmonica companion for Claude Code — design, create, and manage sessions (
/harmonica-chat) - Harmonica docs — Full platform documentation and API reference
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.