# CrowdHum

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/topness-msft/crowdhum-plugin  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/crowdhum

## Description
Create and run live audience polls from your AI assistant, with a scan-to-vote QR and an AI recap.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "crowdhum": {
    "command": "npx",
    "args": ["-y","crowdhum"]
  }
}
```

## Documentation & README

# CrowdHum for your AI assistant

**Run live audience polls without leaving the chat.** Design polls from a deck or
your calendar, launch them with a scan-to-vote QR code, watch votes arrive in real
time, and get an AI recap. This is a portable
[Agent Skills](https://code.claude.com/docs/en/skills) + MCP plugin backed by the
CrowdHum MCP server (`https://mcp.crowdhum.com`).

Works in **Claude Code**, **Claude.ai** (custom connector), the **GitHub Copilot
CLI**, and any MCP client. The same package also targets **Microsoft 365 Copilot /
Cowork**.

> Requires a **CrowdHum Pro** account. The MCP server is Pro-gated and authenticates
> via OAuth on first use. No secrets live in this plugin.

## What you can do

Ask your assistant in plain language:

- "Turn this deck into a 3-question poll set, and give me the QR link to share."
- "Run a word cloud for my standup: one word for how this sprint felt."
- "My room code is XKCD. How did people vote, and what's the takeaway?"
- "Given these live results, what should I poll next?"
- "Recap the session we just ran: the themes, the splits, and one line for the stage."

## What's inside

```
crowdhum-plugin/
├── .claude-plugin/
│   ├── plugin.json          # plugin metadata
│   └── marketplace.json     # makes this repo an installable marketplace
├── .mcp.json                # points at https://mcp.crowdhum.com (OAuth auto-negotiated)
├── color.png                # 192×192 icon
├── outline.png              # 32×32 icon
└── skills/
    ├── run-a-live-poll/     # end-to-end: create → share QR → run → results
    ├── design-a-poll/       # pick the visualization + write good choices
    ├── icebreaker-ideas/    # curated opener library, matched to the meeting
    ├── polls-from-content/  # read a deck/PDF/agenda → suggested polls
    ├── polls-from-calendar/ # read upcoming meetings → polls / icebreakers
    ├── adaptive-next-poll/  # read live results → the smart follow-up poll
    ├── session-recap/       # post-event synthesis + shareable recap
    ├── find-or-reuse-a-poll/# look up / resume / clone an existing poll
    └── invite-a-coowner/    # add a co-host to a session
```

Several skills **compose with the host agent's own tools** (reading a PowerPoint,
your calendar, drafting an email). They describe the *capability* needed, not a
specific tool, so they stay portable across hosts and degrade gracefully (they
ask for pasted content when a capability isn't available).

## Install (Claude)

```
/plugin marketplace add topness-msft/crowdhum-plugin
/plugin install crowdhum@crowdhum-plugin
```

Then just ask, e.g. "run a word cloud for my standup", "read this deck and
suggest 3 polls", or "given these results, what should I poll next?"

## Use in Microsoft 365 Copilot / Cowork

The same skills + `.mcp.json` convert to an M365 app package: run the Microsoft
conversion script (`Convert-ClaudePluginToMOS3.ps1`,
https://aka.ms/copilot-cowork-plugin-conversion-script), or author a `manifest.json`
with an `agentConnectors[]` entry pointing at `https://mcp.crowdhum.com`, then package
with the M365 Agents Toolkit and upload.

The MCP tools authenticate with OAuth, so the connector needs an OAuth client
registration in your Microsoft tenant (a Teams Developer Portal "OAuth client
registration" whose reference ID goes in the manifest's `authorization` block).
Creating one requires tenant admin permission.

## The CrowdHum MCP tools these skills use

`create_poll`, `add_poll_to_session`, `get_room_links`, `get_poll_results`,
`get_session`, `get_session_recap`, `list_my_sessions`, `list_my_polls`,
`list_visualizations`, `invite_co_owner`.

Visualization modes: `word-cloud`, `column-drift`, `rising-bubbles`, `ranking`, `qa`.

## Links

- Website: https://crowdhum.com
- Setup guide (all clients): https://mcp.crowdhum.com
- Privacy: https://crowdhum.com/privacy
- Support: hello@crowdhum.com

## License

MIT.