OTP MCP Server

Generates secure One-Time Passwords (OTP) using TOTP and HOTP algorithms.

GitHub

OTP-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 VariableDescription
OTP_MCP_SERVER_DBPath to the tokens database file
OTP_MCP_SERVER_HOSTHost to bind the server to
OTP_MCP_SERVER_PORTPort to bind the server to
OTP_MCP_SERVER_TRANSPORTTransport protocol to use
OTP_MCP_SERVER_PATHPath for HTTP transport
OTP_MCP_SERVER_LOG_LEVELLogging level

Related Servers