About Hypnothera
Hypnothera is an agent skill and plugin for creating personalized hypnosis sessions and multi-day journeys from an assistant’s knowledge of a person. It is for people using Claude Code, Codex, or other agents, and requires approval of an anonymous brief before it is sent to the service.
Key features
- 01Personalized hypnosis scripts
- 02Multi-day journey creation
- 03Brief approval before sharing
- 04Audio rendering with selected voices
- 05Searchable session library
Use cases
- 01Create a session tailored to personal goals
- 02Build a multi-day relaxation journey
- 03Find ready-made sessions by topic
MCP support
The plugin includes a remote MCP server, also available at https://hypnothera.ai/api/mcp. It lets connected clients find and create sessions, continue journeys, and render audio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://hypnothera.ai/api/mcpclaude mcp add --transport http hypnothera https://hypnothera.ai/api/mcp{"mcpServers":{"hypnothera":{"type":"http","url":"https://hypnothera.ai/api/mcp"}}}Open in Cursor{"servers":{"hypnothera":{"type":"http","url":"https://hypnothera.ai/api/mcp"}}}Open in VS Code{"mcpServers":{"hypnothera":{"type":"http","url":"https://hypnothera.ai/api/mcp"}}}{"mcpServers":{"hypnothera":{"serverUrl":"https://hypnothera.ai/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEHypnothera Personal Session — Claude Code plugin
A plugin for Claude Code and Codex (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 (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.
| Tool | What it does | Credits |
|---|---|---|
get_account | Connected account's email, plan, and credit balance | Free, read-only |
list_topics | Library topics such as sleep, calm, focus, and confidence | Free, read-only |
search_sessions | Search the public library of ready-made sessions, which play free at their listen_url | Free, read-only |
get_session | A library session or one of your own, with its status and, once rendered, a playable audio link | Free, read-only |
list_voices | Narrator voices with previews and which ones your plan can use | Free, read-only |
list_journeys | Your multi-day journeys, with each day's plan and status | Free, read-only |
create_session | Writes a personalized session script, or Day 1 of a 2–30 day journey, from a brief you approve first | Spends credits |
continue_journey | Creates the next day of a journey, one day per call | Spends credits |
render_audio | Renders 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.mdin this repo and is mirrored athttps://hypnothera.ai/skills/hypnothera-session/SKILL.md(web repopublic/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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.