What it does
Execute commands in visible VSCode terminal tabs with output capture and session reuse.
- Connects Runs on your computer
- Account or key No key needed
- Category Developer tools
Use together with
Skills that teach the AI this kind of work; they work alongside this one
andrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
graphify
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Why it ranks here
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 6/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 3/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 9/100 |
Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Install
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Vscode Terminal MCP. Follow https://mcp.popnx.com/i/sirlordt-vscode-terminal-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 2/3 checks · Runs on your computer · ✓ Commands checked Nov 13, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Let AI install it
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Vscode Terminal MCP for Claude on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "vscode-terminal": { "command": "npx", "args": [ "-y", "vscode-terminal-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Vscode Terminal MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Open the Claude desktop app’s settings file
SettingsDeveloperEdit Config
Paste these settings and save the file
{ "mcpServers": { "vscode-terminal": { "command": "npx", "args": [ "-y", "vscode-terminal-mcp" ] } } }Quit Claude and open it again
Try it
Use Vscode Terminal MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Vscode Terminal MCP or shows a Vscode Terminal MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Vscode Terminal MCP yet
Vscode Terminal MCP runs on your computer, but ChatGPT can only connect servers that run on the web
What you can do instead
A · Use an app that can connect Vscode Terminal MCP
- Install Node.js on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
- Install Node.js on your computer first (one time)
- Install Node.js on your computer first (one time)
- Install Node.js on your computer first (one time)
B · Others in Developer tools that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
Works with Claude Code, with some setup first
Install Node.js on your computer first (one time)
Let AI install it
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Vscode Terminal MCP for Claude Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user vscode-terminal -- npx -y vscode-terminal-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Vscode Terminal MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Open Terminal
Mac: press Command+Space and type Terminal · Windows: open PowerShell
Paste this command and press Enter
claude mcp add --scope user vscode-terminal -- npx -y vscode-terminal-mcpType /mcp in Claude Code
You should see Vscode Terminal MCP listed as connected
Try it
Use Vscode Terminal MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Vscode Terminal MCP or shows a Vscode Terminal MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
Install Node.js on your computer first (one time)
Let AI install it
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Vscode Terminal MCP for Cursor on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "vscode-terminal": { "command": "npx", "args": [ "-y", "vscode-terminal-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Vscode Terminal MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Open the AI chat in Cursor in Agent mode
Try it
Use Vscode Terminal MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Vscode Terminal MCP or shows a Vscode Terminal MCP tool in the answer, you are connected
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
Install Node.js on your computer first (one time)
Let AI install it
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Vscode Terminal MCP for VS Code on this computer, in this order: 1) Check Node.js with node -v. If it is missing, tell me to install it from https://nodejs.org/en/download; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "vscode-terminal": { "type": "stdio", "command": "npx", "args": [ "-y", "vscode-terminal-mcp" ] } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) No key is needed. 5) Do what we agreed, then check that the Vscode Terminal MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number:
node -vInstall once; it works for everything that needs Node.js
Open the AI chat in VS Code in Agent mode
Try it
Use Vscode Terminal MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Vscode Terminal MCP or shows a Vscode Terminal MCP tool in the answer, you are connected
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
For developers: Terminal commands and JSON settings
Installed on your computer
Claude Code
claude mcp add --scope user vscode-terminal -- npx -y vscode-terminal-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"vscode-terminal": {
"command": "npx",
"args": [
"-y",
"vscode-terminal-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"vscode-terminal": {
"command": "npx",
"args": [
"-y",
"vscode-terminal-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"vscode-terminal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vscode-terminal-mcp"
]
}
}
}These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
At a glance
Which apps can use it
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Related guides
What it can do
Runs on your computer; the tool list appears in your AI app after you install it.
Basic checksi
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
- ✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account sirlordt, which owns the repo
- ! Caution
Still maintained
Code last changed 8 months ago, more than 6 months ago
- ✓ Pass
Has a licence
Uses MIT
- – Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
- – Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
- … Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints
Published vulnerabilities (OSV.dev)
No entries on OSV.dev for vscode-terminal-mcp@0.1.0
Checks only this package version, not every dependency · checked Nov 16, 2026
Makers: ask for a re-check or report wrong info
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/sirlordt-vscode-terminal-mcp)Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
User reviews
No reviews yet
Compared with others in Developer toolsi
- More stars than 77% of the other 6116 servers in this category
- Published to the registry more recently than 5% of the other 6116 servers in this category
- Basic checks equal to or better than 45% of the other 6116 servers in this category
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
Common questions
Is Vscode Terminal MCP safe?
It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
What keys or codes does it need?
The registry does not list a required key, though some servers ask you to sign in on first use.
Does it run on my computer or in the cloud?
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
Is it still maintained?
The GitHub repo last changed 8 months ago, and the latest version (0.1.0) reached the registry 8 months ago.
Which apps can use it?
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.
What can I use instead?
In the same category: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Similar alternatives
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP
Cloudflare MCP servers
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| This one Vscode Terminal MCP | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Cloud or install on your computer |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | No | No | Yes | No | No |
| Basic checks | 2/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| License | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
README from the maker
Open the README
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
vscode-terminal-mcp
MCP server that executes commands in visible VSCode terminal tabs with full output capture. Unlike inline execution, every command runs in a real terminal you can see, scroll, and interact with.
Key Features
- Visible Terminals: Commands run in real VSCode terminal tabs, not hidden processes. You see everything in real time.
- Session Reuse: The
runtool automatically reuses idle sessions, creating new terminals only when needed. - Long-Running Support: Fire-and-forget execution with
waitForCompletion: false, then poll output incrementally withread. - Subagent Isolation: Tag sessions with
agentIdto keep parallel agent workloads separated.
Requirements
- VS Code 1.93+ (for Shell Integration API)
- Node.js 20+
Getting Started
Claude Code
claude mcp add BashTerm -- npx vscode-terminal-mcp@latest
VS Code / Copilot
Add to your .vscode/mcp.json:
{
"servers": { "BashTerm": { "type": "stdio", "command": "npx", "args": ["vscode-terminal-mcp@latest"] } } }
Cursor
Add to your .cursor/mcp.json:
{
"mcpServers": { "BashTerm": { "command": "npx", "args": ["-y", "vscode-terminal-mcp@latest"] } } }
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": { "BashTerm": { "command": "npx", "args": ["-y", "vscode-terminal-mcp@latest"] } } }
Your First Prompt
After installation, try asking:
Run
ls -lain the terminal
You should see a new terminal tab open in VSCode with the command output.
Screenshots
Running a command with run
Permission dialog for exec
Exec result with clean output
Tools
Quick Execution
| Tool | Description |
|---|---|
run | Create (or reuse) a terminal and execute a command in one step. Returns clean output with exit code. |
Session Management
| Tool | Description |
|---|---|
create | Create a new visible terminal session. Returns a sessionId. |
exec | Execute a command in an existing session and capture output. |
read | Read output from a session with pagination. Supports incremental reads and tail mode (offset: -N). |
input | Send text to an interactive terminal (prompts, REPLs, confirmations). |
list | List active sessions. Optionally filter by agentId. |
close | Close a terminal session and its VSCode tab. |
Usage Patterns
Simple Command
The run tool handles everything — creates a terminal if needed, executes, and returns clean output:
> Run npm test
$ npm test
PASS src/utils.test.ts (3 tests) PASS src/index.test.ts (5 tests)
[exit: 0 | 1243ms | session-abc123]
Long-Running Process
For builds, deployments, or any command that takes a while:
> Start `npm run build` without waiting, then check progress
The agent will:
- Call
runwithwaitForCompletion: false— returns immediately - Call
readwithoffset: -10to check the last 10 lines - Repeat until the process completes
Interactive Commands
For commands that need user input:
> Run npm init and answer the prompts
The agent will:
- Call
runwithnpm init - Call
readto see the prompt - Call
inputto send the answer
Parallel Agents
Subagents can work in isolated terminals using agentId:
> Have one agent run tests while another runs the linter
Each subagent gets its own terminal tagged with its agentId, preventing output from mixing.
Configuration
The extension reads configuration from VSCode settings under terminalMcp.*:
| Setting | Type | Default | Description |
|---|---|---|---|
terminalMcp.maxSessions | number | 10 | Maximum concurrent terminal sessions |
terminalMcp.commandTimeout | number | 30000 | Default command timeout in ms |
terminalMcp.maxOutputLines | number | 5000 | Max lines kept in output buffer per session |
terminalMcp.idleTimeout | number | 1800000 | Close idle sessions after this many ms (0 = disabled) |
terminalMcp.blockedCommands | string[] | ["rm -rf /"] | Commands that will be rejected |
Recommended: Set as Preferred Tool
LLM agents like Claude Code have a built-in Bash tool that executes commands inline within the chat. The output is embedded in the conversation and hard to read, especially for commands with verbose output. We recommend telling the agent to prefer this MCP over its built-in Bash tool.
Add the following to your project's CLAUDE.md (or equivalent instructions file):
## Terminal Execution
Prefer the BashTerm MCP tools (run, exec, read, etc.) over the built-in Bash tool for executing commands. BashTerm runs commands in visible VSCode terminal tabs where the user can see output in real time. Only fall back to the built-in Bash tool for simple, non-interactive operations like reading environment variables.
For commands that may take longer than 30 seconds or produce large amounts of output (builds, test suites, deployments, installs), use the pull mode pattern:
- Call
runwithwaitForCompletion: falseto launch the command without blocking. - Call
readwithoffset: -10to check the last 10 lines of output. - Repeat step 2 until you see the command has finished (look for exit messages, prompts, or "Done").
- Report the final result to the user.
This prevents conversation timeouts and lets the user watch progress in the terminal in real time.
Why this matters:
| Built-in Bash | BashTerm MCP | |
|---|---|---|
| Output visibility | Embedded in chat, hard to scroll | Visible in VSCode terminal tab |
| Real-time feedback | User sees nothing until command finishes | User watches output live |
| Long-running commands | Blocks the conversation until timeout | Fire-and-forget + polling |
| Session state | Each command is isolated | Persistent sessions with history |
| Interactive commands | Not supported | Send input to prompts/REPLs |
Development: Updating the Extension
VSCode aggressively caches extensions in memory. When developing locally, code --install-extension and even "Developer: Reload Window" may not reload your changes. Use this workflow:
Quick update (no restart needed)
After modifying source files, build and copy directly into the installed extension directory:
cd /path/to/vscode-terminal-mcp
npm run build cp dist/extension.js ~/.vscode/extensions/sirlordt.vscode-terminal-mcp- /dist/extension.js
Then run "Developer: Reload Window" (Ctrl+Shift+P).
Full reinstall (when quick update doesn't work)
If VSCode still uses old code:
# 1. Uninstall and remove all copies
code --uninstall-extension sirlordt.vscode-terminal-mcp rm -rf ~/.vscode/extensions/sirlordt.vscode-terminal-mcp-*
2. Check for ghost entries with old publisher names
Look in ~/.vscode/extensions/extensions.json for stale entries
Remove any entries with old publisher IDs (e.g., "terminal-mcp.vscode-terminal-mcp")
3. Close VSCode completely (not just reload)
4. Rebuild and install
npm run build npx vsce package --allow-missing-repository code --install-extension vscode-terminal-mcp- .vsix --force
5. Open VSCode
Verify the correct version is loaded
# Check which extension directories exist
ls ~/.vscode/extensions/ | grep terminal
Verify your changes are in the installed extension
grep "YOUR_UNIQUE_STRING" ~/.vscode/extensions/sirlordt.vscode-terminal-mcp-*/dist/extension.js
Compare checksums
md5sum dist/extension.js ~/.vscode/extensions/sirlordt.vscode-terminal-mcp-*/dist/extension.js
Large Output Handling
When read returns output that exceeds the MCP client's token limit, the system automatically saves the full output to a temporary JSON file and returns the file path in the error message.
To extract the relevant content:
# Get the last 50 lines (most relevant for status)
tail -50 /path/to/saved/file.txt
Or parse the JSON to extract the text content
python3 -c "import json; data=json.load(open('/path/to/file.txt')); print(data0[-2000:])"
The file format is JSON: [{"type": "text", "text": "..."}]
This commonly happens with commands that produce heavy TUI output (progress bars, ANSI escape codes). Use smaller offset values (e.g., offset: -20 instead of offset: -100) to reduce the captured output size.
How It Works
- The VSCode extension activates and starts an IPC server on a Unix socket
- The MCP entry point (
mcp-entry.js) is spawned by the MCP client and bridges JSON-RPC stdio with the IPC socket - Commands execute in real VSCode terminals using the Shell Integration API for reliable output capture and exit code detection
- Output is stored in circular buffers with pagination support for efficient reading
Latest Changes (0.1.6)
- Screenshots in README for marketplace
- Clean output format for all tools — no more raw JSON
- Fixed
waitForCompletion: falsenot working - Disabled idle reaper — user closes sessions manually
- Unique IPC socket per workspace (multi-instance support)
- Custom terminal tab names with date format
- Large output handling documentation
See CHANGELOG.md for full history.
License
MIT