OfficeIMO for AI agents · MCP server, plugin and skills

Give your AI agent real document tools.

Claude, Codex, GitHub Copilot, Cursor and other agents inspect, search and convert your Word, Excel, PowerPoint, PDF and mail files through OfficeIMO, on your own computer.

Install for your agent View the plugin

15 MCP tools
2 Agent Skills
Local and read-first

Runs locally with the .NET SDK · Only the folders you allow · MIT licensed

Agents · OfficeIMO

# Claude Code
❯ claude plugin marketplace add EvotecIT/OfficeIMO

# Codex
❯ codex plugin marketplace add EvotecIT/OfficeIMO --ref master --sparse .agents/plugins

# Any other MCP client
❯ dotnet dnx [email protected] mcp serve --stdio

Documents stay on your computer

The OfficeIMO MCP server runs locally, started by your agent with dotnet dnx. It opens only files inside the folders you name in OFFICEIMO_MCP_ALLOWED_ROOTS and refuses to start without one. Nothing is uploaded by OfficeIMO; what the agent sends to its model is up to the agent and the parts it fetches.

Search first, then fetch what matters

Agents start with a bounded inspection and a narrow search, then fetch only the results they need, a page at a time. A mailbox of thousands of messages never lands in the conversation whole, and document text is treated as untrusted content rather than instructions.

Read freely, write only where asked

Inspection, search and fetching never change a file. Conversion and the PDF tools write a new file at a path you name, and keep existing files unless you ask to replace them. Protected PDFs keep their permissions, and passwords come from the host's environment rather than the conversation.

Task	Ask your agent	Tools it uses
Summarize a report	"Summarize the risks section of Q3-report.docx"	Inspect, search, fetch
Find a message	"Find the email from Anna about the invoice in archive.pst"	Mail search, fetch
Extract for a model	"Convert handbook.pdf to Markdown in notes/"	Convert
Prepare PDFs	"Combine these scans into one PDF"	Assemble, and OCR where the host registered a text-recognition provider
Check a change	"Compare pages 1 to 5 of the old and new contract"	Compare

The same operations are available from the OfficeIMO command line for scripts and CI.

Install

Add OfficeIMO to your agent

Ready Install with the client's own plugin or MCP commands
Manual setup Add the MCP server to the client's configuration
Listed Find OfficeIMO in the directory today
Planned On the roadmap; follow the link for details

Claude Code

Ready

Plugin with skills and MCP server

Adds the plugin marketplace from GitHub, then installs the plugin with its two skills and the MCP server.

claude plugin marketplace add EvotecIT/OfficeIMO

claude plugin install officeimo-document-tools@officeimo

Codex

Ready

Plugin with skills and MCP server

The Codex CLI and app read the same plugin from the repository's plugin marketplace.

codex plugin marketplace add EvotecIT/OfficeIMO --ref master --sparse .agents/plugins

codex plugin add officeimo-document-tools@officeimo

VS Code with GitHub Copilot

Ready

MCP server

Installs the MCP server for agent mode, with the open workspace folder as the folder it may read and write.

Install in VS Code

Cursor

Ready

MCP server

Adds the MCP server to Cursor, with the open workspace folder as the folder it may read and write.

Add to Cursor

Claude Desktop

Manual setup

MCP server

Add the server under mcpServers in Settings › Developer › Edit Config, with the folders it may use, then restart Claude.

{
  "mcpServers": {
    "officeimo": {
      "command": "dotnet",
      "args": ["dnx", "[email protected]", "mcp", "serve", "--stdio"],
      "env": { "OFFICEIMO_MCP_ALLOWED_ROOTS": "/path/to/your/documents" }
    }
  }
}

Gemini CLI, JetBrains, Windsurf, Zed and other MCP clients

Manual setup

MCP server

Any client that starts local stdio MCP servers runs the same command; set the allowed folders in its environment.

dotnet dnx [email protected] mcp serve --stdio

Every client needs the .NET SDK 10 or later. The server reads and writes only inside the folders named in OFFICEIMO_MCP_ALLOWED_ROOTS (separated by : on macOS and Linux, ; on Windows), refuses to start without one, and runs on your computer: documents are not sent anywhere by OfficeIMO.

What the agent can do

15 MCP tools and 2 skills

Skill

`officeimo-document-operator`

Inspect, search, summarize, extract or convert Word, Excel, PowerPoint, PDF, OpenDocument, OneNote, Markdown, HTML, CSV and EPUB files, and make separate PDF outputs.

Skill

`officeimo-mailbox-operator`

Search and inspect MSG, EML, PST, OST, OLM, EMLX and Mbox mail without loading a whole mailbox into the conversation.

Tool	What it does	Changes files
`officeimo_inspect`	Metadata and a structural summary of a document or mail store	Reads only
`officeimo_inspect_email`	Mail metadata, charset and attachment diagnostics, and HTML safety findings	Reads only
`officeimo_search`	Search a document or mailbox and return hits to fetch selectively	Reads only
`officeimo_search_email`	Bounded search of mail bodies, recipients and attachment names	Reads only
`officeimo_fetch`	Fetch one chosen result, a page at a time	Reads only
`officeimo_capabilities`	Which formats and operations are supported	Reads only
`officeimo_convert`	Write a document as Markdown or Reader JSON	Writes a new file you name
`officeimo_pdf`	Extract pages, decrypt with the owner's password, flatten, optimize or sanitize into a new PDF	Writes a new file you name
`officeimo_pdf_split`	Split a PDF into parts in a new folder	Writes a new file you name
`officeimo_pdf_assemble`	Combine PDFs and images, in order, into one PDF	Writes a new file you name
`officeimo_pdf_export_pages`	Save chosen pages as images	Writes a new file you name
`officeimo_pdf_ocr_providers`	Text-recognition providers the host registered	Reads only
`officeimo_pdf_ocr`	Make a searchable copy of a scanned PDF	Writes a new file you name
`officeimo_pdf_print_plan`	Plan printed sheets without contacting a printer	Reads only
`officeimo_pdf_compare`	Compare pages of two PDFs and save an HTML report	Writes a new file you name