persona
Bringing real-time voice to life.
Persona is a cross-platform desktop MCP server that adds an animated visual character to voice conversations with AI assistants. The server exposes animation playback, window visibility, and status reporting tools through a local HTTP MCP endpoint, allowing AI agents like Codex to control an expressive desktop avatar that responds to voice output. It monitors audio playback from voice assistant applications in real-time and animates the character during speech, creating a visual presence for conversational AI without capturing microphone input, transcribing content, or sending audio over the network.
Key Features
Use Cases
- 01Adding visual personality to local voice assistant deployments running language models
- 02Creating interactive desktop avatars for Codex or other MCP-compatible AI agents
- 03Building expressive character responses for voice-based conversational AI applications
- 04Developing desktop companions that react to AI assistant speech output
- 05Prototyping animated character interfaces for local LLM voice stacks
- 06Designing visual feedback systems for multi-modal AI assistant experiences
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
persona — FAQ
What is Persona MCP server?+
Persona is a desktop application that runs a local MCP server, allowing AI agents to control an animated character that visualizes voice assistant conversations. It monitors audio playback from voice apps and provides animation, window control, and status tools via an MCP endpoint.
How do I connect Persona to Codex or other MCP clients?+
First launch Persona, then register its MCP server with your client. For Codex, run 'codex mcp add persona --url http://127.0.0.1:47831/mcp' to enable animation and window control tools in new sessions.
What are the prerequisites for running Persona?+
You need Node.js 24 or newer, npm, and a desktop session with hardware-accelerated graphics. Linux requires pw-dump and pw-record on PATH; Windows needs build 20348 or newer; macOS requires version 14.2 or later. The character model and animations are included, but you must configure the voice audio source in Settings.
Which AI clients work with Persona MCP server?+
Persona works with Codex and any MCP-compatible client that can connect to local HTTP MCP servers. The server exposes standard MCP tools for animation playback, window visibility control, and status reporting.
Is Persona free and open source?+
Yes, the source code is licensed under the MIT License. Character assets under public/assets/ have separate license terms detailed in the repository's LICENSES.md file.
Does Persona require API keys or cloud services?+
No, Persona runs entirely locally and does not send audio over the network, capture microphone input, or require external API keys. The optional Kimodo animation generation feature requires a separately installed local Kimodo server but also operates offline.
How do I install persona?+
Open the source repository on GitHub and follow its README. persona is a mcp server — MCP Agents Market links you directly to the official repo.
Is persona free?+
persona is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.