Skip to main content
Auggie runs commands and tools automatically. Only use integrations and MCP servers from trusted sources, and be aware of the risks of combining multiple tools with external data sources or production systems.

About Integrations and MCP

Auggie can utilize external integrations through native integrations like GitHub, Linear, and Notion and Model Context Protocol (MCP) to access external systems for information and integrate tools to take actions. MCP is an open protocol that provides a standardized way to connect AI models to different data sources and tools.

Native Integrations

You’ll need to configure the integration in Augment for VS Code or JetBrains IDEs. Once configured, the integration will be available for use with Auggie automatically. See a full list and examples for native agent integrations.

1. Setup in Augment extension

  • Visual Studio Code: Click the settings icon in the top right of Augment’s chat window or press Cmd/Ctrl Shift P and select Show Settings Panel
  • JetBrains IDEs: Click the Augment icon in the bottom right of your JetBrains IDE and select Tool Settings

2. Connect the integration

Click “Connect” for the integration you want to set up Set up integrations in the settings page You’ll be redirected to authorize the integration with the appropriate service. After authorization, the integration will be available for use with Augment Agent.

MCP Integrations

In addition to native integrations, Auggie can also access external systems through Model Context Protocol (MCP) servers. MCP servers enable Auggie to interact with external tools and services through a standardized protocol, such as accessing databases, running browser automation, sending messages to Slack, or integrating with APIs.

Configure MCP via settings.json

You can persist MCP servers in the Augment settings file ~/.augment/settings.json, which will initialize on startup and can be checked with /mcp-status.
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"],
      "env": {
        "CONTEXT7_API_KEY": "your_api_key",
        "CONTEXT7_PROJECT_ID": "proj_123"
      }
    },
    "weather-api": {
      "transport": "sse",
      "url": "https://weather-mcp.example.com/sse"
    },
    "local-tool": {
      "command": "/usr/local/bin/custom-mcp",
      "args": ["--serve", "--port", "3000"],
      "env": { "DEBUG": "true" }
    }
  }
}

Manage MCP servers with the Auggie CLI

You can add and inspect MCP servers is via Auggie subcommands, which will persist the configuration to your ~/.augment/settings.json file:

Usage

Add MCP server:
auggie mcp add <name> [options]
Writes the server entry to your settings.json with interactive prompts for overwriting existing configurations. Options:
  • --command <path> - Executable path (for stdio transport)
  • --args <args> - Arguments string for command
  • -e, --env <KEY=VAL> - Environment variable (repeatable)
  • -t, --transport <transport> - stdio|sse (default: “stdio”)
  • -u, --url <url> - SSE URL (required for —transport sse)
  • -r, --replace - Overwrite existing entry without prompt
  • --json - Output JSON
List MCP servers:
auggie mcp list [options]
Lists configured MCP servers (from settings and any active overrides). Options:
  • --json - Output JSON format
Remove MCP server:
auggie mcp remove <name> [options]
Cleanly removes the named server configuration from settings.json. Examples:
# Add a stdio-based MCP server (executable with args and environment)
auggie mcp add context7 \
  --command npx \
  --args "-y @upstash/context7-mcp@latest" \
  --env CONTEXT7_API_KEY=your_key

# Compressed syntax 
auggie mcp add context7 -- npx -y @upstash/context7-mcp

# Add an SSE-based MCP server (Server-Sent Events with URL)
auggie mcp add weather-api \
  --transport sse \
  --url https://weather-mcp.example.com/sse

# Compressed syntax
auggie mcp add weather-api --transport sse https://weather-mcp.example.com/sse

# List all configured servers (tabular display with status)
auggie mcp list

# List servers in JSON format for programmatic access
auggie mcp list --json

# Remove a server configuration
auggie mcp remove context7

# Replace existing server without interactive prompt
auggie mcp add context7 --command npx --args "..." --replace

MCP overrides

You can define servers by passing ad‑hoc overrides with --mcp-config. The structure is the same as settings.json:
// After npm install gitlab-mr-mcp
{
  "mcpServers": {
    "gitlab-mr-mcp": {
      "command": "node",
      "args": ["/path/to/gitlab-mr-mcp/index.js"],
      "env": {
        "MR_MCP_GITLAB_TOKEN": "your_gitlab_token",
        "MR_MCP_GITLAB_HOST": "your_gitlab_host"
      }
    }
  }
}