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. Its 6 documented tools cluster into run & execute, read & search, create & write, close. It runs locally over stdio via the published package.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-03-20 · ★ 2 · #654 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Vscode Terminal MCP

Claude Code

claude mcp add sirlordt-vscode-terminal-mcp -- npx -y vscode-terminal-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "sirlordt-vscode-terminal-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vscode-terminal-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package vscode-terminal-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.sirlordt is GitHub-verified and matches the repo owner

03 · What Vscode Terminal MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create (or reuse) a terminal and execute a command in one step. Returns clean output with exit code, create a new visible terminal session. Returns a sessionId, execute a command in an existing session and capture output, and read output from a session with pagination. Supports incremental reads and tail mode (offset: -N).

Capability map

Tools grouped from the project's README - what Vscode Terminal MCP lets an agent do.

run & execute

2 tools - e.g. Create (or reuse) a terminal and execute a command in one step. Returns clean output with exit code.; Execute a command in an existing session and capture output.

run · exec

read & search

2 tools - e.g. Read output from a session with pagination. Supports incremental reads and tail mode (offset: -N).; List active sessions. Optionally filter by agentId.

read · list

create & write

1 tool - e.g. Create a new visible terminal session. Returns a sessionId.

create

Close

1 tool - e.g. Close a terminal session and its VSCode tab.

close

04 · Who maintains Vscode Terminal MCP

vscode-terminal-mcp is maintained by sirlordt. It's the only MCP server we track from this author; the repo dates to Mar 2026.

05 · Facts

repository
github.com/sirlordt/vscode-terminal-mcp
category
other - ranked #654 of 848 actively-maintained other servers as of 2026-08-25.
registry
io.github.sirlordt/vscode-terminal-mcp (active, first published 2026-03-18)
packages
npm:vscode-terminal-mcp

06 · Vscode Terminal MCP FAQ

Is Vscode Terminal MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-03-20. We re-verify nightly.

What can Vscode Terminal MCP do?

With this server connected, an agent can create (or reuse) a terminal and execute a command in one step. Returns clean output with exit code, create a new visible terminal session. Returns a sessionId, execute a command in an existing session and capture output, and read output from a session with pagination. Supports incremental reads and tail mode (offset: -N).

How do I install Vscode Terminal MCP?

Run `npx -y vscode-terminal-mcp`. You can also paste the ready-made client config above.

Does Vscode Terminal MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Vscode Terminal MCP

Alternatives to Vscode Terminal MCP

Maintained other servers if Vscode Terminal MCP isn't the fit.

  1. Heyputer MCP Server Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more ★ 43,204 · 2026-08-24
  2. Server Commands An MCP server to run arbitrary commands ★ 38,704 · 2026-08-05
  3. Zotero MCP (54yyyu) Search, read, annotate, and add to your Zotero research library, local or web. ★ 4,780 · 2026-08-25
  4. Firebase MCP Gives AI development tools Firebase-specific capabilities and expertise. ★ 4,460 · 2026-08-25
  5. Microsoft Fabric MCP Server MCP tools for interacting with Microsoft Fabric ★ 3,598 · 2026-08-21
  6. Ship Swift 40+ production-ready SwiftUI recipes for building full-stack iOS apps via MCP. ★ 2,968 · 2026-08-09

More MCP servers to compare · Ncloud · Leclerc Drive · Slide Forge · Korean Rnd Regs MCP · Patent Search MCP Server

More TypeScript MCP servers · Sisense MCP Server · Mergewarden · Rekindle · Federal Compass MCP · see all