Plex Account Finder
Verify your Plex accounts and see which servers are available. Search user access across all linked servers with fuzzy matching. Authorize new accounts with a simple flow and complete setup automatically.
Ask AI about Plex Account Finder
Powered by Claude Β· Grounded in docs
I know everything about Plex Account Finder. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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.
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 reload
Type checking & builds:
npm run typecheck
npm run build:stdio
npm run build:shttp
The 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.
