Repository avatar
Multimedia
v1.3.0
active

hypnothera

ai.hypnothera/hypnothera

Personalized hypnosis sessions and multi-day journeys, a free session library, and audio rendering.

Documentation

Hypnothera Personal Session — Claude Code, Codex, Cursor and Gemini CLI plugin

A plugin for Claude Code, Codex, Cursor and Gemini CLI (and a portable skill for other AI agents): turn what your assistant already knows about you into a personalized hypnosis session or multi-day journey on hypnothera.ai.

Your conversations never leave your assistant. The skill distills a short, anonymous brief, shows it to you for approval, and only the approved brief travels to hypnothera.ai — in the link's URL fragment, which browsers don't send to servers.

Install (Claude Code — recommended)

This repo is its own plugin marketplace. Inside Claude Code:

/plugin marketplace add La-Salida/hypnothera-skill
/plugin install hypnothera@hypnothera

Then ask: "Make me a hypnosis session based on what you know about me."

Already have a Hypnothera account? The plugin bundles a remote MCP server. Run /mcp, select hypnothera, and choose Authenticate — a browser opens to connect your account. Your assistant can then find ready-made library sessions, create personalized ones, render their audio in the voice you pick, and continue multi-day journeys, all without leaving the conversation.

Install (Codex)

This repo is also a Codex plugin marketplace:

codex plugin marketplace add La-Salida/hypnothera-skill
codex plugin add hypnothera@hypnothera

The plugin bundles the skill and the Hypnothera MCP server; sign in when Codex prompts you to connect it.

Install (Cursor)

This repo is also a Cursor plugin (.cursor-plugin/plugin.json). Find Hypnothera in the Cursor Marketplace, or install it locally:

git clone https://github.com/La-Salida/hypnothera-skill ~/.cursor/plugins/local/hypnothera

Then run Developer: Reload Window. The plugin bundles the skill and the Hypnothera MCP server; Cursor asks you to sign in the first time a tool runs.

Install (Gemini CLI)

This repo is also a Gemini CLI extension (gemini-extension.json):

gemini extensions install https://github.com/La-Salida/hypnothera-skill

Restart Gemini CLI. The extension bundles the skill and the Hypnothera MCP server; Gemini CLI opens a browser to sign in the first time a tool runs (or run /mcp auth hypnothera).

Install (any MCP client)

Add https://hypnothera.ai/api/mcp as a remote MCP server (Streamable HTTP, OAuth). It is listed in the official MCP Registry as ai.hypnothera/hypnothera.

Tools

The remote MCP server (https://hypnothera.ai/api/mcp) exposes nine tools. None of them delete anything, change billing, or reach the open web.

ToolWhat it doesCredits
get_accountConnected account's email, plan, and credit balanceFree, read-only
list_topicsLibrary topics such as sleep, calm, focus, and confidenceFree, read-only
search_sessionsSearch the public library of ready-made sessions, which play free at their listen_urlFree, read-only
get_sessionA library session or one of your own, with its status and, once rendered, a playable audio linkFree, read-only
list_voicesNarrator voices with previews and which ones your plan can useFree, read-only
list_journeysYour multi-day journeys, with each day's plan and statusFree, read-only
create_sessionWrites a personalized session script, or Day 1 of a 2–30 day journey, from a brief you approve firstSpends credits
continue_journeyCreates the next day of a journey, one day per callSpends credits
render_audioRenders a finished script as audio in the voice you choose (about 1 credit per minute)Spends credits

Full reference: https://hypnothera.ai/help/api-and-agents

Install (manual skill file)

For claude.ai (upload as a skill under Settings → Capabilities, or add to a project), Codex, or any agent that reads skill files, use skills/personal-session/SKILL.md, or:

mkdir -p ~/.claude/skills/hypnothera-personal-session && \
curl -fsSL https://hypnothera.ai/skills/hypnothera-session/SKILL.md \
  -o ~/.claude/skills/hypnothera-personal-session/SKILL.md

More: https://hypnothera.ai/tools/agent-skill

Notes

  • The canonical copy of the skill lives at skills/personal-session/SKILL.md in this repo and is mirrored at https://hypnothera.ai/skills/hypnothera-session/SKILL.md (web repo public/skills/hypnothera-session/SKILL.md). Keep the two in sync when editing.
  • Hypnothera is a wellness and self-improvement tool for relaxation, focus, sleep quality, and confidence — not a medical service.

No installation packages available.

Remote