Integration · Developer tools

Connect Claude & ChatGPT to Mistral AI

Give your AI assistant access to your own Mistral AI workspace. It can pull the text out of a PDF or image with Mistral OCR, transcribe audio, ask one of your Mistral agents a question and read the documents in your libraries. It can also list models, check batch jobs and create or update agents, all with your own API key.

Connect Mistral AI free

Free plan, no credit card. Takes about a minute.

Try asking

“Extract the text from this invoice PDF: https://example.com/invoice.pdf”
The AI runs OCR with a Mistral OCR model and returns the text of each page as markdown.
“Transcribe the recording at this link and split it by speaker.”
It transcribes the audio with a Mistral transcription model and can separate the speakers.
“Ask our Support agent how to reset a customer's password.”
It finds the agent and gets a reply from it, based on the agent's own instructions and tools.

What your AI can do

OCR and transcription

Turn PDFs and images into markdown text with Mistral OCR, and transcribe audio from a URL or an uploaded file.

Agents and conversations

List, create and update agents, get replies from them, and start, continue or read stored conversations.

Libraries, files and batch jobs

Browse document libraries and read their text, list uploaded files and get download links, and check batch jobs.

“What does the contract in our Legal library say about termination?”
It lists the documents in the library, reads the extracted text of the right one and answers from it.
“Which models can we use in our workspace?”
It lists the Mistral models available to your workspace, including your fine-tuned ones.
“Did last night's batch job finish?”
It lists your batch jobs and shows the status of the one you ask about.

72 tools for Mistral AI

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

archive_modelVisible to othersArchive a model (model id). Has effects visible outside this system. API summary: Archive Fine Tuned Model.
archive_model_archiveDeletesArchive a model (model id). Destructive action; may require approval. API summary: Unarchive Fine Tuned Model.
cancel_projectMoves moneyCancel a project (job id). Financial or irreversible action; may require approval. API summary: Cancel Batch Job.
continue_conversationChanges dataSend new `inputs` to an existing conversation (conversation ID in `message_id`) and get the reply.
create_a_conversation_and_append_entries_to_itChanges dataCreate a new message. Required: inputs. API summary: Create a conversation and append entries to it.
create_agentChanges dataCreate an agent with a `name`, `model`, and optional instructions, description and tools.
create_chat_completionChanges dataGenerate a chat reply from a Mistral `model` given a list of `messages` (role and content), with optional temperature, max_tokens and response_format. Uses paid API credits.
create_classificationChanges dataCreate a new classification. Required: model or input. API summary: Classifications.
create_classification_chat_classifications_v1_chat_classificatioChanges dataCreate a new classification. Required: model or input. API summary: Chat Classifications.
create_completion_fim_completion_v1_fim_completions_postChanges dataCreate a new completion. Required: model or prompt. API summary: Fim Completion.
create_document_reprocessChanges dataCreate a new reprocess for a document. API summary: Reprocess a document.
create_embeddingChanges dataCreate a new embedding. Required: model or input. API summary: Embeddings.
create_libraryChanges dataCreate a document library with a `name` and optional description. Libraries hold documents your agents can search.
create_message_agents_api_v1_conversations_append_streamChanges dataCreate a new message. API summary: Append new entries to an existing conversation.
create_message_agents_api_v1_conversations_restartChanges dataCreate a new message for a message. Required: from entry id. API summary: Restart a conversation starting from a given entry.
create_message_agents_api_v1_conversations_restart_streamChanges dataCreate a new message for a message. Required: from entry id. API summary: Restart a conversation starting from a given entry.
create_moderation_chat_moderations_v1_chat_moderations_postChanges dataCreate a new moderation. Required: input or model. API summary: Chat Moderations.
create_projectVisible to othersCreate a new project. Required: endpoint. Has effects visible outside this system. API summary: Create Batch Job.
create_speechChanges dataCreate a new speech. Required: input.
create_transcriptions_streamChanges dataCreate a new transcriptions stream. Required: model. API summary: Create Streaming Transcription (SSE).
create_voiceChanges dataCreate a new voice. Required: name or sample audio.
delete_agentDeletesPermanently delete a agent by agent id. Destructive action; may require approval. API summary: Delete an agent entity.
delete_agent_aliasesMoves moneyPermanently delete a alias by agent id. Financial or irreversible action; may require approval. API summary: Delete an agent version alias.
delete_conversationDeletesPermanently delete a stored conversation by conversation ID in `message_id`. This cannot be undone.
delete_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete File.
delete_libraryDeletesPermanently delete a library by library id. Destructive action; may require approval. API summary: Delete a library and all of it's document.
delete_library_documentDeletesPermanently delete a document by document id. Destructive action; may require approval.
delete_library_sharesMoves moneyPermanently delete a share by library id. Financial or irreversible action; may require approval. API summary: Delete an access level.
delete_modelDeletesPermanently delete a model by model id. Destructive action; may require approval. API summary: Delete Model.
delete_projectMoves moneyPermanently delete a project by project id. Financial or irreversible action; may require approval. API summary: Delete Batch Job.
delete_voiceDeletesPermanently delete a voice by voice id. Destructive action; may require approval. API summary: Delete a custom voice.
extract_document_textChanges dataRun OCR on a PDF or image with a Mistral OCR `model`, passing the `document` (for example a document URL or image URL). Returns the extracted text per page as markdown.
get_agentGet one agent by `agent_id`, including its model, instructions and tools.
get_agent_versionGet one version for a agent by version. API summary: Retrieve a specific version of an agent.
get_batch_jobGet one batch job's status and results by job ID in `project_id`.
get_conversationGet one stored conversation's details by conversation ID in `message_id`.
get_document_statusGet the current status of a document by document id. API summary: Retrieve the processing status of a specific document.
get_fileGet one uploaded file's details by file ID in `document_id`.
get_file_download_urlGet a temporary download URL for an uploaded file by `file_id`, with optional `expiry`.
get_libraryGet one document library by `library_id`.
get_library_documentGet one document's details in a library, by `library_id` and `document_id`.
get_library_document_textGet the extracted text content of a library document, by `library_id` and `document_id`, optionally for a page range.
get_modelGet one model by model id. API summary: Retrieve Model.
get_voiceGet one voice by voice id. API summary: Get voice details.
list_agent_aliasesList aliases for a agent. API summary: List all aliases for an agent.
list_agent_versionsList versions for a agent. Results are paginated. API summary: List all versions of an agent.
list_agentsList your Mistral agents, optionally filtered by `search` or `name`. Results are paginated with `cursor`.
list_batch_jobsList batch jobs, filtered by `status`, `model` or created date.
list_conversation_messagesGet all messages in a stored conversation by `conversation_id`.
list_conversationsList your stored conversations. Results are paginated.
list_document_contentsList contents for a document. API summary: Download File.
list_document_extracted_text_signed_urlsList extracted text signed urls for a document. API summary: Retrieve the signed URL of text extracted from a given document.
list_document_signed_urlsList signed urls for a document. API summary: Retrieve the signed URL of a specific document.
list_filesList files uploaded to your Mistral workspace, filtered by `search`, `purpose` or `source`.
list_librariesList your document libraries, optionally filtered by `search`.
list_library_documentsList or search the documents in a library by `library_id`, with optional `search`, sorting and paging.
list_library_sharesList shares for a library. API summary: List all of the access to this library.
list_modelsList the Mistral models available to your workspace, including fine-tuned ones. Use to pick a model ID for other tools.
list_voice_samplesList samples for a voice. API summary: Get voice sample audio.
moderate_textChanges dataCheck text in `input` for harmful content categories with a Mistral moderation `model`. Returns category scores.
retrieve_all_entries_in_a_conversationList messages for a message. API summary: Retrieve all entries in a conversation.
run_agent_completionChanges dataGet a reply from one of your Mistral agents by `agent_id`, given a list of `messages`. Uses paid API credits.
start_conversationChanges dataStart a stored conversation with a Mistral `model` or agent (`agent_id`) and your first `inputs`. Returns the reply and a conversation ID to continue it.
transcribe_audioChanges dataTranscribe audio to text with a Mistral transcription `model`, from a `file_url` or an uploaded `file_id`. Optional `language` and speaker diarization.
update_agentChanges dataUpdate an agent's name, model, instructions, description or tools by `agent_id`. This creates a new agent version.
update_agent_aliasesVisible to othersUpdate an existing alias identified by agent id. Has effects visible outside this system. API summary: Create or update an agent version alias.
update_agent_versionsVisible to othersUpdate an existing version identified by agent id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update an agent version.
update_libraryChanges dataUpdate an existing library identified by library id. Only the fields you pass are changed. API summary: Update a library.
update_library_documentChanges dataUpdate an existing document identified by document id. Only the fields you pass are changed. API summary: Update the metadata of a specific document.
update_library_sharesVisible to othersUpdate an existing share identified by library id. Has effects visible outside this system. API summary: Create or update an access level.
update_modelChanges dataUpdate an existing model identified by model id. Only the fields you pass are changed. API summary: Update Fine Tuned Model.
update_voiceChanges dataUpdate an existing voice identified by voice id. Only the fields you pass are changed. API summary: Update voice metadata.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Mistral AI from the app list.
2
Paste your key
Paste your Mistral API key. Sign in to the Mistral console (console.mistral.ai), open API Keys in your workspace and click Create new key. Copy the key right away, because it is shown only once.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Mistral AI?

The AI can run chat completions, OCR, transcription and moderation with Mistral models. It can list, create and update agents and get replies from them, start and continue stored conversations, create and read document libraries, list files and check batch jobs.

Does the AI see my Mistral AI API key?

No. Your Mistral AI credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, for example OCR and library search without agent changes. Deleting a stored conversation is permanent and can require your approval before it runs. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Mistral AI account.

Do Mistral API calls use my credits?

Yes. The calls run on your own Mistral workspace with your API key. Tools that generate replies, such as create_chat_completion and run_agent_completion, use paid API credits there. You can switch off the tools you do not want the AI to use.