Plex MCP Account Finder
Connects to multiple Plex accounts to discover media servers, perform fuzzy search for users across servers by email/username, validate account connectivity, and generate PIN-based authentication URLs for token generation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Plex MCP Account Finderfind user with email john.doe@example.com"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Plex MCP Account Finder
Model Context Protocol server that connects to multiple Plex accounts, aggregates server user access, and exposes tools for fuzzy user lookup and login token generation. Built on the official Plex APIs using the smithery TypeScript runtime.
Features
Discover Plex Media Servers across every configured account token.
Fuzzy search for users by email, username, or display name across all servers.
Validate account connectivity and list owned/shared servers with
plex_status.Generate Plex authentication URLs (PIN-based) and poll them to capture new tokens via MCP tools.
Configurable caching to avoid hammering Plex endpoints when running repeated queries.
Related MCP server: discord-user-mcp
Configuration
smithery.yaml already points to src/index.ts. Provide a config object that matches configSchema:
{
"log_level": "info",
"cache_ttl_seconds": 300,
"accounts": [
{ "label": "primary", "token": "<plex-token>" },
{ "label": "secondary", "token": "<plex-token>" }
]
}log_level:debug,info,warn, orerror(default:info).cache_ttl_seconds: cache duration for server/user lookups (30–3600 seconds, default 300).accounts: list of Plex account API tokens plus optional client identifiers. Each token should be an account-level token retrieved from Plex Web or the pin flow.
Tools
plex_status– Summarizes account validity, servers, and optionally user counts.plex_lookup_user– Fuzzy query across all server users (query, optionalmax_results,refresh).plex_generate_auth_url– Produces a PIN-based login URL (client_identifieroptional) for generating new tokens.plex_check_auth_pin– Polls a previously issued PIN (pin_id,client_identifier) and reports whether an auth token is ready.
Development
npm install
npm run dev # runs smithery dev with hot reloadType checking & builds:
npm run typecheck
npm run build:stdio
npm run build:shttpThe generated bundles are stored in .smithery/ and can be deployed directly to Smithery.
Notes
Logging is structured JSON; sensitive values (tokens) are redacted automatically.
The manager caches server and user snapshots for the configured TTL. Use
refresh: truein tool inputs to bypass caches when needed.Plex PIN URLs expire quickly; poll with
plex_check_auth_pinuntilauthTokenis populated, then store that token for future use.
This server cannot be deployed
Maintenance
Related MCP Connectors
Identity resolution MCP server for phone/email lookups across 31+ services. Global + India coverage.
Enrich and search people and companies, resolve identities, and enrich IP addresses.
Managed LinkedIn MCP server for AI agents: search, connect, message and enrich on accounts you own.
Unified social-media data across 10 networks: profiles, posts, search, comments, cross-search.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables search, browsing, and management of Plex media libraries including movies, TV shows, and music, with support for playlists, watch history, natural language music discovery, and detailed media information retrieval.2212 npm5ISC
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Discord using personal user tokens instead of bot applications, allowing for seamless message management and server exploration. It provides tools for reading history, sending messages, and searching across channels and DMs directly through MCP-compatible clients.9MIT
- AlicenseNot gradedqualityBmaintenanceLets AI assistants browse your libraries, search media, get viewing recommendations, check what's on deck, and more — all read-only against your local Plex instance.110 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Plex Media Server via the MCP protocol, allowing AI agents to manage libraries, media, playlists, collections, users, sessions, and server administration.131 PyPI145MIT