authenticator_mcp

This MCP server provides secure access to credentials managed by the Authenticator App (2FA codes and passwords) for use by AI agents through MCP clients. To use it, configure your MCP client with the Authenticator App MCP server entry and supply your access token. Once configured, your agent can request credentials like a 2FA code or a password for a target website, and the MCP server will relay the information through the authenticated channel. Keep in mind that the access token controls access to the Authenticator App data, so treat it as a secret and rotate it regularly. You can also set the AUTHENTICATOR_ACCESS_TOKEN environment variable in your MCP client configuration as an alternative to embedding the token in the command arguments.

Prerequisites:

• Node.js and npm (or npx available)
• Access to the Authenticator App and generation of an MCP access token as described in the README

Installation steps:

1. Install Node.js and npm from https://nodejs.org/ or via your package manager.
2. Obtain an Authenticator App MCP access token from the Authenticator App settings (Settings > MCP Server > Generate token).
3. Add the MCP server configuration to your MCP client config (see the example below).
4. Run the MCP client as you normally would; the client will use npx to fetch the authenticator-mcp package and start the server with your token.

Example configuration snippet to copy into your MCP client config:

{
  "mcpServers": {
    "Authenticator App MCP": {
      "command": "npx",
      "args": ["-y", "authenticator-mcp", "--access-token=YOUR-KEY"]
    }
  }
}

Notes:

• If you prefer not to include the token in the command, you can set AUTHENTICATOR_ACCESS_TOKEN=YOUR-KEY in the env section of your MCP client config (if supported).
• Restart the MCP client after updating the configuration.

Tips and caveats:

• The access token is shown only once when generated; store it securely. Rotate tokens periodically.
• Ensure network access to any services the Authenticator App integrates with (firewalls, VPNs, etc.).
• If you encounter permissions issues with npx, try running with elevated privileges or clear npm cache.
• The MCP server is designed for use with AI agents that can securely request credentials; never expose tokens in client logs or UI histories.
• For Windows users, an equivalent config using cmd can be used, as shown in the README's Windows example.