ATOMSATOMSDocs
Getting Started

Installation

Install and configure ATOMS MCP Server in 2 minutes

Installation

Install the package

npm install -g @atoms-tech/atoms-mcp

Or run directly with npx : no global install needed:

npx @atoms-tech/atoms-mcp@latest

Authenticate

npx @atoms-tech/atoms-mcp@latest login

This opens your browser for OAuth login. Once approved, credentials are stored securely at ~/.atoms/credentials.json.

Add to your AI assistant

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "atoms-mcp": {
      "command": "npx",
      "args": ["@atoms-tech/atoms-mcp@latest"]
    }
  }
}

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp@latest

That's it. The server is now available in your Claude Code sessions.

Open Cursor Settings, navigate to MCP Servers, and add:

  • Name: atoms-mcp
  • Command: npx
  • Args: @atoms-tech/atoms-mcp@latest

Verify

npx @atoms-tech/atoms-mcp@latest whoami

You should see your email and authentication status.

For CI/CD and headless environments, see Authentication for token-based auth.

Updating atoms-mcp

A config with no tag keeps running the copy npx cached the first time, so it does not update on its own. In your MCP client config, set the args to @atoms-tech/atoms-mcp@latest, then restart the client:

"args": ["@atoms-tech/atoms-mcp@latest"]

If your config writes -y today, keep it:

"args": ["-y", "@atoms-tech/atoms-mcp@latest"]

atoms-mcp checks for a newer version once a day and tells you in atoms_status and in the next tool result. Set ATOMS_MCP_NO_UPDATE_CHECK=1 to turn the check off.

On this page