Converts structured forms into conversational audio interviews and exports the results as JSON.
Also known as msanchezgrice/audioform, audioform, @talkform/mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Oct 27, 2026
- License
- —
What is Talkform MCP?
Talkform converts structured forms into conversational audio interviews and exports the results as JSON.
Summary generated from the project's README
About Talkform MCP server
Talkform functions as a config-driven utility that transforms structured forms into interactive audio interviews. It allows developers to define specific data fields which the system then collects through conversational speech. Once the interview concludes, the tool exports the gathered information as JSON-ready session results. This server is designed for developers building products that require conversational data intake rather than static text inputs.
Users can interact with the system via an agent-friendly CLI or an embeddable React widget. Setting up the environment requires an OpenAI API key and a specified realtime model, such as gpt-realtime-2.1. For machine clients to communicate with the web API, you must configure the TALKFORM_API_TOKEN and AUDIOFORM_API_TOKEN environment variables. The system includes a local MCP schema and config-validation server to ensure templates remain accurate during development.
What you can do with it
- 1Automated data collectionConvert a standard data entry form into a live audio interview session.
- 2Structured data extractionCollect conversational responses and export them directly into a JSON format.
Written from the project's README. Every use case is checked against a quote from it.
How to install Talkform MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Talkform MCP in Claude Code
$ claude mcp add audioform -- npx -y @talkform/mcpInstall Talkform MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"audioform": {
"command": "npx",
"args": [
"-y",
"@talkform/mcp"
]
}
}
}Install Talkform MCP in VS Code
.vscode/mcp.json
{
"servers": {
"audioform": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@talkform/mcp"
]
}
}
}Install Talkform MCP in VS Code CLI
$ code --add-mcp '{"name":"audioform","type":"stdio","command":"npx","args":["-y","@talkform/mcp"]}'Install Talkform MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"audioform": {
"command": "npx",
"args": [
"-y",
"@talkform/mcp"
]
}
}
}Install Talkform MCP in Codex
$ codex mcp add audioform -- npx -y @talkform/mcpInstall Talkform MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.audioform] command = "npx" args = ["-y", "@talkform/mcp"]
Install Talkform MCP in Gemini CLI
$ gemini mcp add -s user audioform npx -- -y @talkform/mcpInstall Talkform MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"audioform": {
"command": "npx",
"args": [
"-y",
"@talkform/mcp"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablemsanchezgrice/audioform is public and reachablegithub.com/msanchezgrice/audioform ↗Pass
- Package names this repository as its source@talkform/mcp names msanchezgrice/audioform as sourcenpmjs.com/package/@talkform/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-27github.com/msanchezgrice/audioform ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @talkform/mcpPass
- No critical advisory in the package or its dependencies100 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 224 msPass
README
View on GitHubTalkform
Turn any form into a live audio interview.
Talkform is a config-driven audio intake utility. Products define the fields they need, Talkform asks for them conversationally, binds structured values directly into the form, and exports JSON-ready session results.
Workspace
apps/web: hosted app fortalkform.aipackages/core: config schema, realtime prompt/tool generation, session/result helperspackages/react: embeddable React widgetpackages/http: process-local transient session and HTTP helperspackages/cli: agent-friendly CLIpackages/mcp: local MCP schema, template, and config-validation serverdocs: markdown documentation rendered in the web app
Core commands
pnpm install
pnpm dev
pnpm build
pnpm typecheck
Environment
OPENAI_API_KEYOPENAI_REALTIME_MODELdefaultgpt-realtime-2.1OPENAI_REALTIME_VOICEdefaultmarinTALKFORM_ENABLE_IMPORT_AI_REFINEMENToptional; onlytrueenables paid AI copy refinement after deterministic importNEXT_PUBLIC_AUDIOFORM_VENDORNEXT_PUBLIC_AUDIOFORM_VENDOR_URL
Transient session APIs and public Realtime client-secret issuance are disabled in hosted production by default. A production deployment needs a durable session store, a distributed rate limiter, and server authentication before those endpoints should be enabled. The current in-memory store and quotas are development/reference implementations; they do not provide cross-instance durability or enforcement.
Machine clients use two matching environment variables:
TALKFORM_API_TOKEN: server-only bearer token accepted by the web APIAUDIOFORM_API_TOKEN: client-side token read by the Talkform CLI
For a controlled deployment, TALKFORM_ENABLE_IN_MEMORY_SESSIONS=true and TALKFORM_ENABLE_PUBLIC_REALTIME=true opt into the reference endpoints. Do not use these flags to represent the current process-local implementations as production-ready infrastructure.
Talkform MCP questions
How do I add Talkform MCP to Claude Code?
Run claude mcp add audioform -- npx -y @talkform/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Talkform MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What does Talkform do?
Talkform is a config-driven utility that turns forms into live audio interviews, binding structured values into forms and exporting JSON results.
Is the current session implementation production-ready?
No, the current in-memory store and quotas are for development and reference only and do not provide cross-instance durability.