TOTP

Provides a TOTP-based 2FA code generator for Claude Code automation with account-scoped secrets loaded from an external file.

javascript

0

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "stig-johnny-totp-mcp": {
      "command": "node",
      "args": [
        "/path/to/.claude/mcp-servers/totp/index.js"
      ],
      "env": {
        "SECRETS_FILE": "~/.nutrie-secrets"
      }
    }
  }
}

This MCP server generates 6-digit TOTP codes for configured accounts to automate Claude Code workflows. Each code remains valid for about 30 seconds and the server reads secrets from an external file, keeping sensitive data separate from code.

How to use

Use the MCP client to request a TOTP code for a specific account and to list configured accounts. You can generate codes for accounts like google or github and monitor how long each code remains valid. The server reads your secrets from an external file, so you don’t store them in code.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system. You can verify by running node -v and npm -v.

cd ~/.claude/mcp-servers/totp
npm install

Additional content

Configuration, security notes, and an example MCP setup are provided below to help you deploy and use this server effectively.

Available tools

get_totp_code

Generate a TOTP code for a specific configured account. Requires the account name and returns the current 6-digit code along with its remaining validity time.

list_totp_accounts

List all configured TOTP accounts and their current status, showing which secrets are mapped and ready to generate codes.