The VSCode Model Context Protocol (MCP) Server is a monorepo containing both the MCP Server and its companion VSCode Extension. This project enables AI agents and assistants, such as Goose or Claude, to interact with VSCode through the Model Context Protocol.
vscode-mcp/
├── server/ # MCP server implementation
└── extension/ # VS Code extension
Install the MCP Server
shell
npx vscode-mcp-server install
Install the MCP Extension
code-mcpVS CodeAllows interaction with VS Code through the Model Context Protocolnpx vscode-mcp-serverAdd this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"vscode-mcp-server": {
"command": "npx",
"args": ["vscode-mcp-server"],
"env": {}
}
}
}
The Code MCP server provides the following tools for AI agents to interact with VS Code:
create_diffCreates and shows a diff for modifying existing files:
- Shows changes preview before applying
- Requires user approval
- Only works with existing files
open_fileOpens files in the VS Code editor:
- Used for viewing new or modified files
open_projectOpens a project folder in VS Code:
- Sets up working directory for AI agent
check_extension_statusChecks if extension is installed and responding
get_extension_portGets the port number for VS Code MCP Extension
list_available_projectsShows projects from port registry file
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Copyright 2025 Block, Inc.
This product includes software developed at Block, Inc.