Log inSubmit server
Interactive MCP logo

Interactive MCP

by ttommyth

Adds local prompts, notifications, and multi-question chat sessions to MCP workflows.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Interactive MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ttommyth-interactive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "interactive-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 5 tools correctly (23d ago).

Overview

ttommyth/interactive-mcp MCP server connects an MCP client to local user prompts, operating-system notifications, and command-line chat sessions. It exposes tools for asking questions, collecting responses in a persistent session, and signaling completion. Run it locally with an MCP client when an agent needs clarification or confirmation during setup, coding, or other multi-step work. It requires local operating-system access and supports Windows, macOS, and Linux.

Use cases

  • Clarify ambiguous implementation requirements
  • Confirm file edits or complex commands
  • Gather several setup decisions in one session
  • Collect feedback during code generation
  • Notify users when an agent finishes

Key features

  • Pop-up user input prompts
  • Predefined options for questions
  • Persistent intensive chat sessions
  • Cross-platform completion notifications
  • Configurable prompt timeout
  • Selective tool disabling

Tools5

What Interactive MCP lets your agent do. Expand a tool for its parameters.

Verified live~3.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

21/22 checks healthy over the last 77d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · interactive-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars351Stargazers on the source repository.
npm downloads267Package downloads in the last 30 days.
Last commit11mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed5Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Interactive MCP works

What ttommyth/interactive-mcp MCP server does

ttommyth/interactive-mcp MCP server adds user interaction to an MCP-based workflow. Rather than requiring an agent to infer every requirement, it can open a prompt, collect an answer, and continue with the returned information. The server is intended for local use alongside an MCP client because its features depend on access to the user’s operating system.

Its tools cover three interaction patterns:

  • request_user_input asks one question through a pop-up command prompt and can present predefined choices.
  • message_complete_notification sends an operating-system notification when work is complete.
  • The intensive-chat tools start, continue, and close a persistent command-line session for several related questions.

Responses can be empty or unavailable when a prompt times out. The default timeout is 30 seconds in the documented client configuration, and the timeout can be changed with a command-line option.

How it works

The MCP client starts the Node.js and TypeScript server as a local process. The agent then invokes the appropriate MCP tool when it needs clarification, confirmation, feedback, or a sequence of answers. A regular prompt returns the user’s response or a timeout result. Intensive chat uses a session identifier: the client starts a session, sends later questions with that identifier, and closes the session when gathering input is finished.

The project’s interaction guidance favors concise questions, predefined options where useful, and confirmation before impactful actions such as editing files or running complex commands. It also advises using other available tools when they can answer a question without involving the user.

Setup and configuration

To use ttommyth/interactive-mcp MCP server, the client must have npx available. Claude Desktop and Cursor use a configuration that starts npx -y interactive-mcp; VS Code uses the same command in its MCP server settings. A specific package version can be supplied by changing the package argument, such as interactive-mcp@1.9.0.

Add -t or --timeout followed by a number of seconds to change the prompt timeout. The server also accepts -d or --disable-tools with a comma-separated list. Supported disable groups are request_user_input, message_complete_notification, and intensive_chat.

Developers modifying the project can clone the repository, install dependencies with pnpm, and run it with pnpm start. The repository also documents pnpm build, pnpm lint, and pnpm format.

Tools and capabilities

The request tool supports project context, a message, and optional predefined options. Intensive chat provides a persistent console window and retains the session history while questions are being asked. The completion tool provides cross-platform notifications on Windows, macOS, and Linux. The documented server platform support includes Windows, macOS, and Linux.

Limitations and notes

ttommyth/interactive-mcp MCP server is designed to run locally, not as a remote-only service, because it needs direct operating-system access for prompts and notifications. Intensive chat sessions must be closed after use, and follow-up questions require the session ID returned when the session starts. On macOS with Terminal.app, the project recommends configuring the shell-exit behavior to manage windows created for the server.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Interactive MCP

ttommyth/interactive-mcp is an MCP server that connects local MCP clients to user prompts, operating-system notifications, and command-line chat sessions. Its main tools ask for input, signal completion, and manage intensive multi-question conversations. It runs locally so it can access the operating system on Windows, macOS, or Linux.

Install it by adding an MCP server entry that runs `npx -y interactive-mcp`. The README provides configurations for Claude Desktop, Cursor, and VS Code. The client must have the `npx` command available.

Change it by adding `-t` or `--timeout` and the number of seconds to the command arguments in your MCP client configuration. The documented default is 30 seconds.

Yes, it works with Cursor through the client’s `mcp.json` configuration. Add a server entry that runs `npx` with `-y` and `interactive-mcp`, then add optional timeout or tool-disabling arguments if needed.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewInteractive MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ttommyth-interactive-mcp?style=directory)](https://allmcps.com/mcp/ttommyth-interactive-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/ttommyth-interactive-mcp"><img src="https://allmcps.com/api/badge/ttommyth-interactive-mcp?style=directory" alt="Interactive MCP on AllMCPs" /></a>