aaif-goose--goose/documentation/docs/mcp/vs-code-mcp.md

title, description, unlisted

title	description	unlisted
VS Code Extension	Use VS Code MCP Server as a goose Extension for file operations and VS Code integration	true

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed';

This tutorial covers how to add the VS Code MCP Server as a goose extension to enable VS Code integration, file operations, and development workflow management.

:::tip Quick Install

Command

npx vscode-mcp-server

Required Setup

Install the VS Code MCP Extension from the Visual Studio Marketplace. :::

Configuration

:::info Note that you'll need Node.js installed on your system to run this command, as it uses npx. :::

1. Add the VS Code MCP Extension to your VS Code. No additional settings required in VS Code.

1. Run the `configure` command: ```sh goose configure ```

2. Choose to add a Command-line Extension

  ┌   goose-configure 
  │
  ◇  What would you like to configure?
  │  Add Extension 
  │
  ◆  What type of extension would you like to add?
  │  ○ Built-in Extension 
  // highlight-start    
  │  ● Command-line Extension (Run a local command or script)
  // highlight-end    
  │  ○ Remote Extension 
  └ 

3. Give your extension a name

  ┌   goose-configure 
  │
  ◇  What would you like to configure?
  │  Add Extension 
  │
  ◇  What type of extension would you like to add?
  │  Command-line Extension 
  │
  // highlight-start
  ◆  What would you like to call this extension?
  │  vscode-mcp
  // highlight-end
  └ 

4. Enter the command

  ┌   goose-configure 
  │
  ◇  What would you like to configure?
  │  Add Extension 
  │
  ◇  What type of extension would you like to add?
  │  Command-line Extension 
  │
  ◇  What would you like to call this extension?
  │  vscode-mcp
  │
  // highlight-start
  ◆  What command should be run?
  │  npx vscode-mcp-server
  // highlight-end
  └ 

5. Enter the timeout value (default 300s is recommended) ```sh ┌ goose-configure │ ◇ What would you like to configure? │ Add Extension │ ◇ What type of extension would you like to add? │ Command-line Extension │ ◇ What would you like to call this extension? │ vscode-mcp │ ◇ What command should be run? │ npx vscode-mcp-server install │ // highlight-start ◆ Please set the timeout for this tool (in secs): │ 300 // highlight-end │ └

6. No additional environment variables are required for basic setup

</TabItem>
<TabItem value="ui" label="goose Desktop">
1. [Launch the installer](goose://extension?cmd=npx&arg=-y&arg=vscode-mcp-server&id=vscode-mcp&name=VS%20Code%20MCP&description=VS%20Code%20integration%20and%20file%20operations)
2. Press `Yes` to confirm the installation
3. Click `Save Configuration`
4. Click `Exit` from the upper left corner
</TabItem>
</Tabs>



## Example Usage

The VS Code MCP extension enables goose to interact with your VS Code environment, managing files, projects, and development workflows. 

The key strength of the VS Code MCP Server is its ability to:

- Show diffs before making changes
- Integrate file operations with VS Code's interface
- Manage project workspaces
- Provide immediate visual feedback in the editor


:::note
Every time you start a goose session with the VS Code MCP server enabled, it checks to see if a matching project is open in VS Code. If not, it will prompt you to open the project before proceeding.
:::

### goose Prompt

Update the contributing guide with instructions on how to start docusaurus dev server

## Result

![session showing goose making updates and VS Code prompting user to accept or reject changes](../assets/guides/vscode-mcp.png)