add_token
Add a new OTP token.
LABSCO SUMMARY
A pattern, not a token name, is the unit of address — and that applies to deletion exactly as it applies to code generation.
get_details, calculate_otp_codes and delete_token all take pattern, so a pattern loose enough to be convenient when fetching a code reaches just as widely when the call is delete_token. The store runs locally and holds no account of its own: what it keeps is the secret handed to add_token, alongside the account, issuer, type, algorithm, digits, period and counter that describe it.
What it is
A local OTP token store, exposing token listing, detail lookup, code calculation, and adding or deleting tokens.
What you get
- list_otp_tokens returns the tokens held, which is what establishes what can be generated before a code is asked for.
- get_details returns the details of the tokens matching a pattern, and calculate_otp_codes returns the current code for the tokens matching one.
- add_token registers a token from its secret, together with account, issuer, type, algorithm, digits, period and counter.
- delete_token removes the tokens matching a pattern.
Requirements
Nothing — no account, no key.
Setup effort
One command — uvx otp-mcp-server
USE CASES
01
Getting through a login prompt without reaching for your phone
See which tokens are stored, then generate the current code for the one the prompt is asking about.
02
Moving an authenticator entry into the store
Register the token from its secret with the parameters the issuer specified, then read the details back to confirm they took.
03
Clearing out tokens for an account you no longer hold
List what is stored so the pattern you are about to delete on is one you have read, then remove the matches.
5 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
calculate_otp_codes
Calculate the OTP code for all tokens matching the pattern.
delete_token
Delete an OTP token matching the pattern.
get_details
Get the details of all the OTP tokens matching the pattern
list_otp_tokens
Returns the list of OTP tokens. Use this to understand which tokens are available before trying to generate code.
BEFORE YOU INSTALL
What to know first
Tools you get
5 tools when we connected.
Requires
uvx on PATH
CONTEXT COST
Light Standing cost
Rated by the size of the 5 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"otp-mcp-server": {
"command": "uvx",
"args": [
"otp-mcp-server"
]
}
}
}uvx
TERMINAL
uvx otp-mcp-server
