OTP-MCP-Server

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