Skip to main content

​
1. Install Auggie CLI

npm install -g @augmentcode/auggie@latest

​
2. Sign in to Augment

auggie login
This will open a browser window for authentication.

​
3. Configure the MCP server in Claude Code

Add the MCP server to user scope (available in all projects):
claude mcp add-json auggie --scope user '{"type":"stdio","command":"auggie","args":["--mcp","--mcp-auto-workspace"]}'
Or add to project scope (only available in the current project):
claude mcp add-json auggie --scope project '{"type":"stdio","command":"auggie","args":["--mcp","--mcp-auto-workspace"]}'

​
4. Test the integration

claude --print "Do you have access to the Augment codebase retrieval tool? Answer in one sentence."
Claude should confirm it has access to the codebase-retrieval tool.

​
Advanced: Non-Interactive Setup

For non-interactive environments like CI/CD pipelines, GitHub Actions, or automated scripts where you cannot run auggie login interactively, you can configure authentication using environment variables.

​
1. Get your authentication session details

auggie token print
This will output your session JSON.

​
2. Configure with environment variables

claude mcp add-json auggie --scope user '{"type":"stdio","command":"auggie","args":["--mcp","--mcp-auto-workspace"],"env":{"AUGMENT_SESSION_AUTH":"<session-json>"}}'
Replace <session-json> with the full session JSON output from step 1.