Installation
Install and configure ATOMS MCP Server in 2 minutes
Installation
Install the package
npm install -g @atoms-tech/atoms-mcpOr run directly with npx : no global install needed:
npx @atoms-tech/atoms-mcp@latestAuthenticate
npx @atoms-tech/atoms-mcp@latest loginThis 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@latestThat'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
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.