Using the AI agent in ONLYOFFICE Desktop Editors

The AI agent is a contextual assistant available within ONLYOFFICE Desktop Editors through a tab.

• The AI agent lets users perform common tasks such as:
• Generate and rewrite text. Create content from scratch or improve existing text without switching between applications, everything is done directly within the desktop app. Generate summaries, expand ideas, rephrase sentences or adapt tone and style simply by describing what you need in natural language.
• Format your documents smarter. Apply formatting without searching through menus with an AI agent. You do not need to look for where a particular button or function is located. Simply type your request and the editor will update the content instantly.
• Analyze and visualize data. Aggregate, sort and filter information within your spreadsheets, and generate visual representations from selected ranges or entire sheets. Create charts and images based on data for your slides from simple descriptions, all integrated into your workflow.

The AI agent keeps your conversation history, allowing you to refine results step by step or continue complex requests.

Accessing the AI agent tab

1. Launch ONLYOFFICE Desktop Editors.
2. On the left panel, click the AI agent tab. When you open the tab for the first time, you will see the "Connect an AI Model to Get Started" message, click the Connect an AI Model button to choose the AI provider. The AI agent settings panel opens.

Configuring the AI agent

The AI agent settings panel consists of three tabs:

• Connection - allows you to connect your own AI sources,
• MCP Servers - allows you to add and configure MCP servers and enable tools that can be invoked by language models,
• Web Search – allows you to connect an external web search engine and leverage a combination of AI chats and real-time Internet access for better results.

Connection tab

Use this tab to link your own AI provider using the provider's API key or the locally hosted model for full control over data privacy.

1. Click the Add provider button.

   

   In the AI Provider dialog that appears:

   

2. Choose a provider from the Provider drop-down list. The AI providers available so far are Anthropic, Ollama, OpenAI, TogetherAi, OpenRouter, Google AI, DeepSeek, xAI, LM Studio, and Mistral.

3. Type the Name of the AI source to recognize this provider in the list.

4. In the URL field, leave the default endpoint or specify the one required by your provider.

5. Enter the API key obtained from your provider account.

6. Click the Add provider button when the setup is complete.

The provider appears in the Connection tab. You can manage it later: Edit the settings or Delete the provider.

MCP Servers tab

Use this tab to add and configure MCP servers and enable their tools that extend AI capabilities beyond your local environment. You can add up to 100 tools. Enable or disable the available tools to suit your needs, or use the actions menu to enable or disable all tools at once.

ONLYOFFICE Desktop Editors is shipped with the desktop-editor MCP tools enabled by default. Click desktop-editor in the Available tools field to expand the list of tools. The default tools include:

• file_content_reader – returns the content of a file in a specific format (txt, html).
• file_opener - opens a file.
• folder_content_reader - lists the content of a folder.
• form_field_analyser - analyzes a document or a form.
• form_field_filler - fills in a document or a form.
• generate_docx - generates a text document (report, article, letter, etc.) based on a description.
• generate_form - generates a form or a document template (contract, any document to be filled in) based on a description.
• generate_pptx - generates a complete presentation with a custom theme, fonts and content.
• recent_file_reader - lists recently used files

You can add a third-party MCP server and tools.

note

ONLYOFFICE assumes no responsibility for the content, privacy policies or practices of any third-party MCP services.

In the Edit configuration dialog, enter the JSON configuration obtained from the MCP server provider and click Save.

Web Search tab

Use this tab to connect an external web search engine and expand AI capabilities by giving it access to real-time data.

• Use the Web search engine drop-down to choose a search engine. Exa is the only search engine available so far.

• Go to the Exa website to get an API key. Paste the key into the API key field and click Save.

• Use the Reset settings button to edit the web search settings.

  

Using the AI chat

note

To be able to use the AI agent for file and content generation to its full potential, the AI plugin must be installed and properly configured within the editors. For more information, please refer to our Artificial Intelligence guide.

Once at least one model has been added, you can start chatting. The top toolbar of the AI agent includes three action buttons: New chat, Settings, and Chat history.

• To start a new chat, click the icon in the top toolbar of the AI agent tab. The Ask AI prompt field with action buttons appears. Use these buttons to fine-tune your prompts.

  

• You can attach local or recent files to your conversation. The AI response will be based on the attached file.

  

• Enable or disable the Web Search and MCP tools.

  

  • When you use web search, the chat displays the list of retrieved sources so you can review the links.

    

  • When you use the MCP Server tools, a notice appears asking you to verify the invoked tools for privacy compliance, since ONLYOFFICE assumes no responsibility for the data privacy compliance of third-party tools and integrations. Check the Always allow this tool to perform this action without asking again option if you do not want this notice to appear again for this tool.

    

• Choose a model to use in this conversation.

  

• Click the arrow icon to send the prompt.

The output appears in the chat, you can view the MCP tools used, if any, and the AI chat suggestions. You can copy the conversation results to the clipboard or save them to your computer as a docx file.

Chat history

The AI agent keeps the history of your AI conversations so that you can review, save or remove them.

• Click the Chat history icon in the upper left corner of the AI Chat.

  

• Use the Search field to find previous conversations by name.

• Click to open the context menu with the following options:

  • Save – to save the conversation as a docx file on your computer.
  • Rename – to change the title of the conversation,
  • Delete – to remove the chat from the history permanently.

When you select a conversation, its full content appears on the right, and you can continue interacting with the AI from where you left off.

Use the arrow to close the Chat history panel.