CueHQSocial/cuehq-plugins

CueHQ watches Reddit, X, YouTube and TikTok for threads where people ask for a product like yours. It ranks them by fit and timing and drafts replies in your voice, and the drafts learn from your edits. You post every reply yourself: CueHQ never posts for you.
This repository packages the CueHQ MCP server at https://www.cuehq.social/mcp with a cues skill that knows the workflow. There is one folder per agent, because their plugin formats differ.
| Folder | Agent |
| repository root | Gemini CLI extension |
| plugins/claude | Claude Code plugin |
| plugins/cursor | Cursor plugin |
## Get an API key
Sign in to CueHQ and open Settings, Agents (https://www.cuehq.social/settings?section=agents). Create a key and copy it when it appears; it is shown once. The free plan includes 14 cues. A key acts as you, so keep it out of shared files. Revoke it in the same place at any time.
## Claude Code
In a Claude Code session:
/plugin marketplace add CueHQSocial/cuehq-plugins
/plugin install cuehq@cuehq
Claude Code asks for the key when it enables the plugin and keeps it in your system's secure storage. Then ask for your cues, for example "Show me today's top three cues and draft a reply to the best one."
Without the plugin, the server can be added on its own:
claude mcp add --transport http cuehq --scope user https://www.cuehq.social/mcp \
--header "Authorization: Bearer cuehqsk..."
## Gemini CLI
gemini extensions install https://github.com/CueHQSocial/cuehq-plugins
The install asks for the CueHQ API key and keeps it in your keychain. To change it later, run gemini extensions config cuehq.
## Cursor
The Cursor plugin is the plugins/cursor folder. It declares one variable, CUEHQAPIKEY, which Cursor's plugin configuration supplies (on team plans, Dashboard, Plugins, Configure).
Without the plugin, add the server to ~/.cursor/mcp.json with CUEHQAPIKEY set in your environment:
json
"mcpServers": {
"cuehq": {
"url": "https://www.cuehq.social/mcp",
"headers": {
"Authorization": "Bearer ${env:CUEHQAPIKEY}"
## VS Code
Add CueHQ to VS Code
Or put this in .vscode/mcp.json. VS Code asks for the key the first time the server starts and stores it as a secret:
json
"inputs": [
"type": "promptString",
"id": "cuehq-api-key",
"description": "CueHQ API key",
"password": true
],
"servers": {
"cuehq": {
"type": "http",
"url": "https://www.cuehq.social/mcp",
"headers": {
"Authorization": "Bearer ${input:cuehq-api-key}"
## Any MCP client
Remote: streamable HTTP at https://www.cuehq.social/mcp with the header Authorization: Bearer . Local: npx -y cuehq-mcp with CUEHQAPIKEY in the environment, from https://github.com/CueHQSocial/cuehq-mcp. The steps for other agents are at https://www.cuehq.social/agents.
## Tools
| Tool | What it does |
| brands | The brands on your account, with each one's plan, handles and how many sources it watches. |
| listcues | A brand's cues, newest first, by tab (all, priority, mentions, competitors) and status (surfaced, engaged, skipped). |