Frenchie

lab94/frenchie-skill

Frenchie gives your AI agent file parsing and multimodal capabilities through a clean MCP interface. It exposes tools for OCR on PDFs and images, audio and video transcription, Office and CSV extraction to Markdown, and image generation from prompts. Results land in `.frenchie/` as Markdown or image files. The package bundles both stdio and HTTP transports, so it works in local agents like Claude Code and Cursor as well as hosted environments like Claude.ai and ChatGPT that only speak HTTP. You get 100 free credits on signup. The same package also ships Frenchie Method, a text-only workflow orchestrator with requirement analysis, test planning, and PR review commands. Reach for this when you need your agent to read documents, parse spreadsheets, transcribe recordings, or generate images without writing integration code yourself.

tools: 7
auth: Secret needed
transport: STDIO, HTTP
env vars: 2
last updated: May 7, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://mcp.getfrenchie.dev --name frenchie-skill --header 'Authorization: Bearer ${API_TOKEN}' --header 'X-Frenchie-Default-Language: ${X_FRENCHIE_DEFAULT_LANGUAGE}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http frenchie-skill https://mcp.getfrenchie.dev --header 'Authorization: YOUR_AUTHORIZATION' --header 'X-Frenchie-Default-Language: YOUR_X_FRENCHIE_DEFAULT_LANGUAGE'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 7 tools

Verified live against the running server on Nov 6, 2026.

ocr_to_markdownConvert PDF/image files into Markdown through Frenchie3 params

Convert PDF/image files into Markdown through Frenchie

Parameters* required

api_keystring

Optional Frenchie API key (fr_...). Falls back to the FRENCHIE_API_KEY env var when omitted.

file_pathstring

Absolute local file path. Stdio transport only — over HTTP, upload via upload_file first and pass uploaded_file_reference instead.

uploaded_file_referencestring

Object key returned by upload_file. Required for HTTP transport; ignored when file_path is provided in stdio.

transcribe_to_markdownConvert audio/video files into Markdown transcripts through Frenchie. Set language (ISO 639-1 code, e.g. 'th', 'en', 'ja') for better accuracy; omit for auto-detection.4 params

Convert audio/video files into Markdown transcripts through Frenchie. Set language (ISO 639-1 code, e.g. 'th', 'en', 'ja') for better accuracy; omit for auto-detection.

Parameters* required

api_keystring

Optional Frenchie API key (fr_...). Falls back to the FRENCHIE_API_KEY env var when omitted.

file_pathstring

Absolute local file path. Stdio transport only — over HTTP, upload via upload_file first and pass uploaded_file_reference instead.

languagestring

Optional ISO 639-1 language code (e.g. 'th', 'en', 'ja') for better accuracy; omit for auto-detection.

uploaded_file_referencestring

Object key returned by upload_file. Required for HTTP transport; ignored when file_path is provided in stdio.

generate_imageGenerate a single image from a text prompt through Frenchie. Required: prompt. Optional: style (free-text style direction), size, quality, format, background. stdio mode auto-saves the image to .frenchie/<slug>/generated.<ext>; HTTP mode returns a presigned imageUrl that the a...8 params

Generate a single image from a text prompt through Frenchie. Required: prompt. Optional: style (free-text style direction), size, quality, format, background. stdio mode auto-saves the image to .frenchie/<slug>/generated.<ext>; HTTP mode returns a presigned imageUrl that the a...

Parameters* required

api_keystring

Optional Frenchie API key (fr_...). Falls back to the FRENCHIE_API_KEY env var when omitted.

backgroundstring

Optional background. transparent is rejected when format is jpeg.one of transparent · opaque · auto

formatstring

Optional output format. Defaults to png.one of png · jpeg · webp

output_dirstring

Stdio mode only: absolute directory under which .frenchie/<slug>/generated.<ext> is saved. Defaults to the MCP server's process cwd. Recommended: pass your workspace root so the image lands next to...

prompt*string

Required. Plain-language description of the image to generate (e.g. 'poster of a ramen shop at night').

qualitystring

Optional output quality.one of low · medium · high · auto

sizestring

Optional output size. Defaults to automatic selection.one of 1024x1024 · 1536x1024 · 1024x1536 · auto

stylestring

Optional style direction (e.g. 'flat vector, neon palette'). Merged into the generation prompt by Frenchie.

extract_to_markdownExtract structured documents (.docx, .xlsx, .csv, .tsv, .pptx) into Markdown through Frenchie. stdio mode auto-saves the result to .frenchie/<name>/result.md; HTTP mode returns inline Markdown.3 params

Extract structured documents (.docx, .xlsx, .csv, .tsv, .pptx) into Markdown through Frenchie. stdio mode auto-saves the result to .frenchie/<name>/result.md; HTTP mode returns inline Markdown.

Parameters* required

api_keystring

Optional Frenchie API key (fr_...). Falls back to the FRENCHIE_API_KEY env var when omitted.

file_pathstring

Absolute local file path. Stdio transport only — over HTTP, upload via upload_file first and pass uploaded_file_reference instead.

uploaded_file_referencestring

Object key returned by upload_file. Required for HTTP transport; ignored when file_path is provided in stdio.

get_job_resultFetch the latest async Frenchie job result2 params

Fetch the latest async Frenchie job result

Parameters* required

api_keystring

Optional Frenchie API key (fr_...). Falls back to the FRENCHIE_API_KEY env var when omitted.

job_id*string

Job ID returned by ocr_to_markdown, transcribe_to_markdown, or generate_image when status was 'processing'.

upload_fileGet a presigned upload URL for use with ocr_to_markdown, transcribe_to_markdown, or extract_to_markdown in HTTP mode. After calling this tool, PUT the file to upload_url (with the correct Content-Type header), then pass object_key as uploaded_file_reference to the processing t...4 params

Get a presigned upload URL for use with ocr_to_markdown, transcribe_to_markdown, or extract_to_markdown in HTTP mode. After calling this tool, PUT the file to upload_url (with the correct Content-Type header), then pass object_key as uploaded_file_reference to the processing t...

Parameters* required

api_keystring

Optional Frenchie API key (fr_...). Falls back to the FRENCHIE_API_KEY env var when omitted.

file_size*integer

File size in bytes.

filename*string

Original filename with extension (e.g. 'report.pdf').

mime_type*string

MIME type (e.g. 'application/pdf', 'audio/mpeg').

fetch_result_fileGet a temporary download URL for a result file from OCR/transcription output. Use this to download images referenced as frenchie-result: in the result markdown.2 params

Get a temporary download URL for a result file from OCR/transcription output. Use this to download images referenced as frenchie-result: in the result markdown.

Parameters* required

api_keystring

Optional Frenchie API key (fr_...). Falls back to the FRENCHIE_API_KEY env var when omitted.

object_key*string

The object key parsed from a frenchie-result:<objectKey> reference in the result markdown.

Configuration

FRENCHIE_API_KEY*secret

Your Frenchie API key (starts with fr_). Create one at https://getfrenchie.dev/dashboard/api-keys — first signup comes with 100 free credits.

FRENCHIE_DEFAULT_LANGUAGE

Optional ISO 639-1 language hint (e.g. 'th', 'en', 'ja') applied to transcribe_to_markdown when the tool input does not specify a language. Tool-level language always wins.

Readme

@lab94/frenchie

Frenchie — your agent's best friend.

Install Frenchie in your coding agent with one command. Frenchie Kit gives agents file and multimodal capabilities: read PDFs and images, transcribe audio and video, extract Office/CSV files to Markdown, and generate images from text prompts. Frenchie Method gives teams a structured workflow from requirement to release.

Upgrading from 0.1.x or 0.2.x? See MIGRATION.md for the breaking changes in 0.3.0 (stdio metadata-only responses, absolute-path MCP configs, new mcp --help / --selftest flags).

This package ships:

View the full README on GitHub

Details

Repository: github.com/lab94/frenchie-skill
Website: getfrenchie.dev
Category: Media & Entertainment
Package: @lab94/frenchie
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Media & Entertainment MCP servers

View all

Distill Mcplakshgk/distill-mcpConvert PDF, DOCX, XLSX, PPTX, HTML, audio to token-efficient Markdown for any MCP client.0stars

Clipacanvasmechreaper007x/clipacanvasRender HTML, CSS, SVG, and Canvas animations to MP4 locally via Playwright/Chromium and FFmpeg.0stars

Alpha (Mossland)mosslandopendevs/alpha-mcpKorean crypto × AI media MCP — channel stance, daily briefs, RAG, canonical store, AI personas.0stars

identifAI MCP Servernet.identifai/mcpDetect AI-generated images, videos, and audio with identifAI's deepfake detection tools.0stars

Sales Teamnet.settro/sales-teamPublic Settro sales MCP tools for missed-call ROI, direct-order recovery, social ordering, and fit.0stars

Particle Propro.particle/particle-proPodcast intelligence for agents: transcripts, clips, speaker diarization, mention tracking.0stars