How to add Augments MCP Server to Claude Desktop

Real-time framework docs (types + prose + examples) for any npm package via MCP. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 124★ · stdio · no auth

Claude Desktop config for Augments MCP Server

claude mcp add -s user augments -- npx -y @augmnt-sh/augments-mcp-server

{
  "mcpServers": {
    "augments-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@augmnt-sh/augments-mcp-server"
      ],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Augments MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Augments MCP Server's tools appear under the 🔌 tools menu.

Before you start

Node.js (npx available)
Optional: a GITHUB_TOKEN (GitHub personal access token) for higher GitHub API rate limits

What Augments MCP Server can do in Claude Desktop

get_api_context

Primary tool. Returns API signatures, prose documentation, and code examples for any npm package. Handles natural language queries with intent detection, now with documentation-first BM25 search.

search_apis

Search for APIs across frameworks by keyword or concept. 25 synonym clusters (e.g. "state" matches useState, createStore, atom, etc).

get_version_info

Get npm version info, compare versions, and detect breaking changes backed by real changelogs.

get_migration_guide

Cross-version migration guide with breaking changes, new features, deprecations, type diffs, and official migration docs.

diagnose_error

Diagnose errors using curated patterns, GitHub Issues search, and troubleshooting docs.

compare_packages

Compare 2-5 npm packages: downloads, bundle size, GitHub stars, dependencies, exported APIs.

scan_project_deps

Scan package.json for outdated, deprecated, and insecure dependencies.

diagnostics

Server health: version, uptime, memory, cache stats, Node.js version.

Security

Runs locally via npx. No authentication required. Optionally set the GITHUB_TOKEN environment variable to a GitHub personal access token for higher GitHub API rate limits when fetching examples and documentation.

Augments MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Augments MCP Server config there under the "mcpServers" key and restart the client.

Is Augments MCP Server safe to use with Claude Desktop?

Which npm packages are supported?

Every npm package is supported out of the box (~2.5M packages) with no curation or configuration. Augments resolves docs automatically via documentation search, TypeScript types, auto-discovered docs, and README fallback. 22 popular frameworks additionally have curated doc sources for richer examples.

Do I need an API key or token?

No. The server runs locally via npx and requires no authentication. You can optionally set the GITHUB_TOKEN environment variable to a GitHub personal access token to get higher GitHub API rate limits when fetching examples and documentation.

How is it different from Context7?

Augments combines TypeScript types with BM25-indexed docs and README content (types must be correct, docs supplement), returns smaller intent-aware context (~500-2000 tokens), supports any npm package via auto-discovery, and adds migration guides, error diagnosis, and dependency scanning.

View repo Full Augments MCP Server page