interactive-mcp
A local, cross-platform MCP server that lets LLM agents ask users questions, send OS notifications, and run command-line chat sessions.
At a Glance
Self-hosted local MCP server released under the MIT License, free to use, copy, modify and distribute.
Engagement
Available On
Listed Nov 2026
About interactive-mcp
interactive-mcp is an open-source MCP server written in Node.js/TypeScript by ttommyth. It enables interactive communication between an LLM and the user, so an AI assistant can ask for input or confirmation instead of guessing. It runs locally next to the MCP client, such as Claude Desktop, Cursor or VS Code, because it needs direct access to the user's operating system. The README notes the project is in its early stages.
What It Is
interactive-mcp is a human-in-the-loop MCP server. It exposes tools that let an agent prompt the user in a command-line window, show OS notifications, and hold a persistent chat session. It is meant for workflows where the model needs user input while it works on the local machine.
Tools and Workflow
The server exposes five tools:
request_user_inputasks a question and returns the answer, optionally with predefined options.message_complete_notificationsends a simple OS notification.start_intensive_chat,ask_intensive_chatandstop_intensive_chatopen, use and close a persistent command-line chat session.
User prompts time out after 30 seconds by default. The timeout can be changed with the -t flag, and tools or tool groups can be disabled with --disable-tools.
Setup Path
Clients launch the server through npx -y interactive-mcp, configured in claude_desktop_config.json, Cursor's mcp.json, or VS Code settings. A specific version can be pinned. Developers can clone the repository and use pnpm to install, build, lint and format. On macOS with Terminal.app, the README suggests setting the profile to close the window when the shell exits cleanly.
Typical Use Cases
The README lists interactive setup or configuration, gathering feedback during code generation, clarifying instructions or confirming actions in pair programming, and any workflow that needs user confirmation. It also suggests prompt instructions telling the LLM to ask clarifying questions and offer options before making significant changes.
Community Discussions
Be the first to start a conversation about interactive-mcp
Share your experience with interactive-mcp, ask questions, or help others learn from your insights.
Pricing
Open Source
Self-hosted local MCP server released under the MIT License, free to use, copy, modify and distribute.
- MIT License
- Runs locally alongside the MCP client via npx
- Tools: request_user_input, message_complete_notification, start_intensive_chat, ask_intensive_chat, stop_intensive_chat
- Cross-platform: Windows, macOS, Linux
Capabilities
Key Features
- Ask users questions with optional predefined options
- OS notifications on task completion
- Persistent command-line intensive chat sessions
- Configurable prompt timeout (default 30 seconds)
- Ability to disable specific tools or tool groups
- Runs locally via npx
- Cross-platform: Windows, macOS, Linux
Integrations
Demo Video

