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

npx @atoms-tech/atoms-mcp login

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

Add to your claude_desktop_config.json:

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

Config file location:

claude mcp add atoms-mcp -- npx @atoms-tech/atoms-mcp

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

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

npx @atoms-tech/atoms-mcp whoami

You should see your email and authentication status.

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