plex-mcp-server
by aminamos
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PLEX_URL | No | Plex Media Server base URL (flag: --plex-url). Default: discovered from plex.tv. | |
| PLEX_TOKEN | Yes | X-Plex-Token for the server (flag: --plex-token). | |
| PLEX_SERVERS | No | Extra servers for cross-server search. | |
| MCP_HTTP_HOST | No | HTTP bind host (flag: --host). | 127.0.0.1 |
| MCP_HTTP_PATH | No | HTTP bind path (flag: --path). | /mcp |
| MCP_HTTP_PORT | No | HTTP bind port (flag: --port). | 3000 |
| MCP_LOG_LEVEL | No | Log level: debug, info, warn, error (stderr only). | info |
| MCP_TRANSPORT | No | Transport to use: stdio or http (flag: --transport). | stdio |
| MCP_AUTH_TOKEN | No | Static bearer token for HTTP transport access control. | |
| PLEX_MAX_ITEMS | No | Cap on items returned from one list endpoint. | 250 |
| PLEX_READ_ONLY | No | Do not register or allow anything that is not GET (flag: --read-only). | off |
| PLEX_TOOL_MODE | No | Tool registration mode: all = one tool per documented operation; curated = only the hand-written tools (flag: --tools). | all |
| PLEX_TOOL_TAGS | No | Restrict tools to these OpenAPI tags, e.g. Library,Status (flag: --tags). | |
| MCP_OAUTH_ISSUER | No | OAuth 2.1 issuer for HTTP transport access control (RS256, verified against the issuer's JWKS). | |
| PLEX_CLOUD_TOKEN | No | plex.tv account token for account, watchlist and Discover access (flag: --cloud-token). Falls back to PLEX_TOKEN. | |
| PLEX_CACHE_TTL_MS | No | In-memory GET cache TTL in milliseconds; 0 disables the cache. | 0 |
| PLEX_TOOL_EXCLUDE | No | Filter tools by name substring to exclude (flag: --exclude). | |
| PLEX_TOOL_INCLUDE | No | Filter tools by name substring to include (flag: --include). | |
| MCP_OAUTH_AUDIENCE | No | OAuth 2.1 audience for HTTP transport access control. | |
| PLEX_OUTPUT_FORMAT | No | Output format: json, compact (tabular), or auto (shortest) (flag: --format). | auto |
| PLEX_SERVERS_TOKENS | No | Tokens for the extra servers used for cross-server search. | |
| OPENSUBTITLES_API_KEY | No | Enables the subtitle tools. | |
| PLEX_CLIENT_IDENTIFIER | No | Stable X-Plex-Client-Identifier (flag: --client-identifier). Default: generated once, then cached. | |
| PLEX_REQUEST_TIMEOUT_MS | No | HTTP request timeout in milliseconds. | 30000 |
| PLEX_MAX_DESCRIPTION_LENGTH | No | Cap on generated tool descriptions. | 1200 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues