Skip to main content
Glama
Sign In
otp-mcp-server

otp-mcp-server

by andreax79
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

OTP-MCP-Server

MCP Server Build Status PyPI version Python 3.11+ License: MIT Ruff

Model Context Protocol (MCP) server that provides OTP (One-Time Password) generation

A Model Context Protocol (MCP) server built with FastMCP that provides secure OTP (One-Time Password) generation. Supports TOTP (Time-based) and HOTP (HMAC-based) algorithms and multiple transport options including stdio, SSE, and HTTP Stream for seamless integration with AI assistants and applications.

Quick Start

Installation

# Use uvx for isolated execution
uvx otp-mcp-server

# Or install from PyPI
pip install otp-mcp-server

Basic Usage

# Run with STDIO (default, for Claude Desktop)
otp-mcp-server

# Run with HTTP Stream transport
otp-mcp-server --http-stream --host 127.0.0.1 --port 8000

# Run with SSE transport
otp-mcp-server --sse --host 127.0.0.1 --port 8000

Using with Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "otp": {
      "command": "uvx",
      "args": ["otp-mcp-server"]
    }
  }
}

Configuration

You can configure the server using command-line arguments or environment variables.

Environment Variable

Description

OTP_MCP_SERVER_DB

Path to the tokens database file

OTP_MCP_SERVER_HOST

Host to bind the server to

OTP_MCP_SERVER_PORT

Port to bind the server to

OTP_MCP_SERVER_TRANSPORT

Transport protocol to use

OTP_MCP_SERVER_PATH

Path for HTTP transport

OTP_MCP_SERVER_LOG_LEVEL

Logging level

Available Tools

5 tools
add_tokenC
Add a new OTP token.

Args:
    secret: Base32 encoded secret key
    issuer: Issuer of the OTP token
    account: Accout for the OTP token
    type: Type of the OTP token (TOTP or HOTP) (default is TOTP)
    algorithm: Hashing algorithm to use (SHA1, SHA256, SHA512, MD5) (default is SHA1)
    counter: Counter value for HOTP tokens (default is 0)
    digits: Number of digits in the OTP code (default is 6)
    period: Time period for TOTP tokens in seconds (default is 30)

Inputs: secret (required), issuer (required), account (required), type, +4 more.

calculate_otp_codesC
Calculate the OTP code for all tokens matching the pattern.

Args:
    pattern: Token pattern (part of the name or token number)

Inputs: pattern (required).

delete_tokenC
Delete an OTP token matching the pattern.

Args:
    pattern: Token pattern (part of the name or token number)

Inputs: pattern (required).

get_detailsC
Get the details of all the OTP tokens matching the pattern

Args:
    pattern: Token pattern (part of the name or token number)

Inputs: pattern (required).

list_otp_tokensA

Returns the list of OTP tokens. Use this to understand which tokens are available before trying to generate code.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: add_token creates tokens, calculate_otp_codes generates codes, delete_token removes tokens, get_details retrieves token metadata, and list_otp_tokens enumerates available tokens. There is no functional overlap between these operations.

    Naming Consistency4/5

    Four tools follow a consistent verb_noun pattern (add_token, delete_token, get_details, list_otp_tokens), but calculate_otp_codes uses a verb_object format that slightly deviates from the pattern. The naming is still highly readable and predictable.

    Tool Count5/5

    With 5 tools, this server is well-scoped for OTP management. It covers the essential CRUD operations (add, delete, list, get details) plus code calculation, which is the core functionality. No tool feels redundant or missing for the domain.

    Completeness5/5

    The toolset provides complete coverage for OTP token management: creation (add_token), retrieval (list_otp_tokens, get_details), usage (calculate_otp_codes), and deletion (delete_token). There are no obvious gaps in the lifecycle or functionality for this domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • My Little MCP Server

      drdudda-org
      A
      license
      A
      quality
      D
      maintenance
      A simple MCP server that provides current time in Korean timezone (KST) with multiple format options and generates random numbers within customizable ranges.
      2
      MIT

    • simplemcp

      vielhuber
      A
      license
      Not graded
      quality
      C
      maintenance
      A simple PHP MCP server that auto-discovers tool classes via reflection and authenticates requests via static bearer token or rotating TOTP codes.
      1
      MIT

    • productivity-toolkit-mcp

      ForgeSynapse
      A
      license
      Not graded
      quality
      D
      maintenance
      Comprehensive MCP server offering password generation, QR code creation, Base64 encoding/decoding, UUID generation, and color palette tools with secure API key authentication.
      ISC