Vscode Terminal Mcp
Runs shell commands in visible VSCode terminal tabs instead of hidden processes, giving you real-time output you can scroll through and interact with. The run tool handles one-shot commands with clean output capture, while create/exec/read let you manage persistent sessions for long-running builds or interactive prompts. Session reuse keeps your workspace tidy, and agentId tags let parallel agents work in isolated terminals without cross-contamination. Fire off slow commands with waitForCompletion false, then poll incrementally with read to avoid blocking your LLM conversation. Requires VSCode 1.93+ for Shell Integration API support. Worth setting as your preferred execution tool over inline Bash when you need to watch output live or handle commands that take more than a few seconds.
- GitHub stars
- 1
- tools
- 7
- transport
- STDIO
- last updated
- Mar 18, 2026
Tools
7 toolsPublic tool metadata for what this MCP can expose to an agent.
runCreate (or reuse) a terminal and execute a command in one step. Returns clean output with exit code.
Create (or reuse) a terminal and execute a command in one step. Returns clean output with exit code.
No parameter schema in public metadata yet.
createCreate a new visible terminal session. Returns a `sessionId`.
Create a new visible terminal session. Returns a `sessionId`.
No parameter schema in public metadata yet.
execExecute a command in an existing session and capture output.
Execute a command in an existing session and capture output.
No parameter schema in public metadata yet.
readRead output from a session with pagination. Supports incremental reads and tail mode (`offset: -N`).
Read output from a session with pagination. Supports incremental reads and tail mode (`offset: -N`).
No parameter schema in public metadata yet.
inputSend text to an interactive terminal (prompts, REPLs, confirmations).
Send text to an interactive terminal (prompts, REPLs, confirmations).
No parameter schema in public metadata yet.
listList active sessions. Optionally filter by `agentId`.
List active sessions. Optionally filter by `agentId`.
No parameter schema in public metadata yet.
closeClose a terminal session and its VSCode tab.
Close a terminal session and its VSCode tab.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
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:
Details
- Repository
- github.com/sirlordt/vscode-terminal-mcp
- Category
- Developer Tools
- Package
vscode-terminal-mcp- Transport
- STDIO
- Registry
- MCP registry, active
Related Developer Tools MCP servers
View all
Git Mcp Servercyanheads/git-mcp-serverComprehensive Git MCP server enabling native git tools including clone, commit, worktree, & more.245stars
Atlassian Dc Mcp Jirab1ff/atlassian-dc-mcpMCP server for Atlassian Jira Data Center - search, view, and create issues108stars
Atlassian Rovo MCP Serveratlassian/atlassian-mcp-serverConnect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.1.1Kstars
Atlassiansooperset/mcp-atlassianProvides MCP access to Jira and Confluence data and actions via tokens and environment-based configuration.5.2Kstars
MCP Git Ingestadhikasp/mcp-git-ingestA Model Context Protocol (MCP) server that helps read GitHub repository structure and important files.306stars
Atlassian Extendedvish288/mcp-atlassian-extendedJira/Confluence MCP server (MCP 2026-07-28): sprints, boards, attachments; writes or read-only3stars