Skip to content
Back to search

officeimo

MarketplaceWorks with Claude CodeGitHub

MIT-licensed, COM-free .NET libraries for creating, reading, editing, converting, rendering, and extracting Office, PDF, email, OneNote, and text formats.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/EvotecIT/OfficeIMO with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/EvotecIT/OfficeIMO'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/evotecit--officeimo/badge.svg)](/listings/evotecit--officeimo)

HTML

<a href="/listings/evotecit--officeimo"><img src="/api/listings/evotecit--officeimo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install only the native packages and adapters an application needs. Unversioned `dotnet add package` commands select the current stable NuGet release.

dotnet add package OfficeIMO.Word
dotnet add package OfficeIMO.Word.Pdf

dotnet add package OfficeIMO.Excel
dotnet add package OfficeIMO.Excel.Html
dotnet add package OfficeIMO.Excel.Pdf

dotnet add package OfficeIMO.Epub
dotnet add package OfficeIMO.Epub.Image

dotnet add package OfficeIMO.Adf
dotnet add package OfficeIMO.Confluence

dotnet add package OfficeIMO.Reader.Pdf

# Add every Reader adapter only when a broad ingestion host genuinely needs all formats.
dotnet add package OfficeIMO.Reader.All

dotnet add package OfficeIMO.OneNote
dotnet add package OfficeIMO.OneNote.Markdown
dotnet add package OfficeIMO.OneNote.Html
dotnet add package OfficeIMO.OneNote.Pdf
dotnet add package OfficeIMO.Reader.OneNote

Keep OfficeIMO package references in one application on the same published version.

Install the unified CLI with `dotnet tool install --global OfficeIMO.Tool`. See the [OfficeIMO.Tool guide](OfficeIMO.Tool/README.md) for global and repository-local installation, common commands, and contributor usage.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "officeimo",
  3. "owner": {
  4. "name": "EvotecIT"
  5. },
  6. "plugins": [
  7. {
  8. "name": "officeimo-document-tools",
  9. "source": "./.agents/plugins/officeimo-document-tools",
  10. "description": "Inspect, search, selectively fetch, and convert local documents and mail stores with OfficeIMO."
  11. }
  12. ],
  13. "metadata": {
  14. "description": "Local OfficeIMO document and mailbox tools with portable agent skills."
  15. }
  16. }
README.md · README · 203 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # OfficeIMO
  2. [![CI](https://github.com/EvotecIT/OfficeIMO/actions/workflows/dotnet-tests.yml/badge.svg?branch=master)](https://github.com/EvotecIT/OfficeIMO/actions/workflows/dotnet-tests.yml)
  3. [![license](https://img.shields.io/github/license/EvotecIT/OfficeIMO.svg)](LICENSE)
  4. [![Discord](https://img.shields.io/discord/508328927853281280?style=flat-square&label=discord%20chat)](https://evo.yt/discord)
  5. OfficeIMO creates, edits, reads and converts Word, Excel, PowerPoint, PDF, Markdown and two dozen other document formats in .NET, without Microsoft Office or COM. New documents start from a theme, so a table, chart or slide looks finished without styling each element by hand.
  6. PowerShell users get the same engines through [PSWriteOffice](PowerShell/PSWriteOffice/README.MD), which lives in this repository.
  7. ## Install
  8. ```sh
  9. dotnet add package OfficeIMO
  10. ```
  11. `OfficeIMO` brings Word, Excel, PowerPoint, PDF and Markdown, the conversions between them, `OfficeConverter` and the document reader. To keep a dependency small, reference only the [packages](#packages) you use.
  12. ## Quick start
  13. A Word report, an Excel table with a chart and a PowerPoint deck from the same data, each also saved as PDF:
  14. <!-- powerforge:code source="Build/DocumentationExamples/QuickStart/Program.cs" region="QuickStart" -->
  15. ```csharp
  16. using OfficeIMO;
  17. using OfficeIMO.Excel;
  18. using OfficeIMO.Excel.Pdf;
  19. using OfficeIMO.PowerPoint;
  20. using OfficeIMO.PowerPoint.Pdf;
  21. using OfficeIMO.Word;
  22. using OfficeIMO.Word.Pdf;
  23. Sale[] sales = [new("North", 182_400m, 0.12), new("South", 141_900m, 0.08), new("West", 97_300m, -0.03)];
  24. using (var report = WordDocument.Create("Sales.docx")) {
  25. report.AddHeading("Quarterly sales", level: 1);
  26. report.AddParagraph("Revenue by region for the third quarter.");
  27. report.AddTable(sales);
  28. report.AddChart(OfficeChartType.Column, sales, nameof(Sale.Region), nameof(Sale.Revenue));
  29. report.Save();
  30. report.SaveAsPdf("Sales.pdf");
  31. }
  32. using (var book = ExcelDocument.Create("Sales.xlsx", new ExcelCreateOptions { Theme = OfficeTheme.Modern })) {
  33. ExcelSheet sheet = book.AddSheet("Sales");
  34. sheet.AddTable(sales, new OfficeTableOptions { Name = "Sales" });
  35. sheet.AddChart(OfficeChartType.Column, sales, nameof(Sale.Region),
  36. new ExcelChartOptions { Title = "Revenue by region", Row = 2, Column = 6 }, nameof(Sale.Revenue));
  37. book.Save();
  38. book.SaveAsPdf("Sales-workbook.pdf");
  39. }
  40. using (var deck = PowerPointDocument.Create("Sales.pptx")) {
  41. deck.AddSlide().AddTitle("Quarterly sales");
  42. PowerPointSlide chartSlide = deck.AddSlide();
  43. chartSlide.AddTitle("Revenue by region");
  44. chartSlide.AddChart(OfficeChartType.Column, sales, nameof(Sale.Region), new PowerPointChartOptions {
  45. Left = OfficeLength.Centimeters(2.3), Top = OfficeLength.Centimeters(5.5),
  46. Width = OfficeLength.Centimeters(29), Height = OfficeLength.Centimeters(12)
  47. }, nameof(Sale.Revenue));
  48. deck.Save();
  49. deck.SaveAsPdf("Sales-deck.pdf");
  50. }
  51. record Sale(string Region, decimal Revenue, double Growth);
  52. ```
  53. <!-- /powerforge:code -->
  54. Every format follows the same shape:
  55. | Job | API |
  56. | --- | --- |
  57. | Create, load and save | `{Format}Document.Create(path)`, `Load(path)`, `Save()`, `Save(path)`, `SaveAsync(stream)` |
  58. | Add content | `AddHeading`, `AddParagraph`, `AddTable(rows)`, `AddChart(type, rows, category, values)`, `AddImage`; each returns what it created |
  59. | Write another format | `doc.SaveAsPdf(path)`, `doc.SaveAsHtml(path)`; returns an `OfficeConversionReport` |
  60. | Convert in memory | `doc.ToMarkdown()`, `markdown.ToWord()` |
  61. | Convert files or folders | `OfficeConverter.Convert(input, output)`, `OfficeConverter.ConvertAsync(files, outputDirectory, target)` |
  62. | Read for search or AI | `OfficeDocumentReader` from `OfficeIMO.Reader.All` |
  63. Conversions report what the target could not carry. `report.HasLoss` and `report.ThrowIfLoss()` check it; `FailOnLoss` in the conversion options turns loss into an error.
  64. ### Themes
  65. `OfficeTheme` carries the palette, fonts, type scale, table and chart styles. The built-in themes are `Modern` (the default), `Classic`, `Minimal`, `Boardroom` and `Dark`. Loading an existing document never restyles it.
  66. Colors can name theme roles instead of literal values, so output follows the theme:
  67. ```csharp
  68. using OfficeIMO;
  69. OfficeColor brand = OfficeColor.Accent1;
  70. OfficeColor alert = OfficeColor.Danger;
  71. OfficeLength margin = OfficeLength.Centimeters(2.5);
  72. ```
  73. ### Convert files and folders
  74. ```csharp
  75. using OfficeIMO;
  76. OfficeConversionReport report = OfficeConverter.Convert("Sales.docx", "Sales-copy.pdf",
  77. new OfficeConversionOptions { FileConflictPolicy = OfficePublicationPolicy.Replace });
  78. Console.WriteLine($"{report.Target}: {report.Diagnostics.Count} diagnostics");
  79. OfficeBatchReport batch = await OfficeConverter.ConvertAsync(
  80. Directory.EnumerateFiles("Reports", "*.docx"),
  81. outputDirectory: "Pdf",
  82. target: OfficeDocumentFormat.Pdf,
  83. new OfficeBatchOptions { MaxParallelism = 4, ConflictPolicy = OfficePublicationPolicy.Replace });
  84. Console.WriteLine($"{batch.Summary.Completed} converted, {batch.Summary.Failed} failed");
  85. ```
  86. `OfficeConverter` refuses to replace an existing output unless the conflict policy says so. A batch reports every file and can resume an interrupted run from a checkpoint (`OfficeBatchOptions.ResumeFrom`, which needs the default `Fail` policy).
  87. ## Packages
  88. Install a format package for that format alone. Conversion adapters are named `OfficeIMO.{Source}.{Target}` and bring only the two engines they join.
  89. | Format | Package | Document type | Common adapters |
  90. | --- | --- | --- | --- |
  91. | Word `.docx`, `.doc` | [OfficeIMO.Word](OfficeIMO.Word/README.md) | `WordDocument` | `.Word.Pdf`, `.Word.Markdown`, `.Word.Html`, `.Word.Rtf`, `.Word.OpenDocument` |
  92. | Excel `.xlsx`, `.xls` | [OfficeIMO.Excel](OfficeIMO.Excel/README.md) | `ExcelDocument` | `.Excel.Pdf`, `.Excel.Html`, `.Excel.Csv`, `.Excel.OpenDocument` |
  93. | PowerPoint `.pptx`, `.ppt` | [OfficeIMO.PowerPoint](OfficeIMO.PowerPoint/README.md) | `PowerPointDocument` | `.PowerPoint.Pdf`, `.PowerPoint.Html`, `.PowerPoint.OpenDocument` |
  94. | PDF | [OfficeIMO.Pdf](OfficeIMO.Pdf/README.md) | `PdfDocument` | `.Pdf.Word`, `.Pdf.Excel`, `.Pdf.PowerPoint`, `.Pdf.Ocr` |
  95. | Markdown | [OfficeIMO.Markdown](OfficeIMO.Markdown/README.md) | `MarkdownDocument` | `.Markdown.Pdf`, `.Markdown.Html` |
  96. | HTML | [OfficeIMO.Html](OfficeIMO.Html/README.md) | `HtmlDocument` | `.Html.Pdf`, `.Html.Rtf` |
  97. | Visio `.vsdx` | [OfficeIMO.Visio](OfficeIMO.Visio/README.md) | `VisioDocument` | `.Visio.Pdf` |
  98. | Project `.mpp`, `.xml` | [OfficeIMO.Project](OfficeIMO.Project/README.md) | `ProjectDocument` | |
  99. | Access `.accdb`, `.mdb` | [OfficeIMO.Access](OfficeIMO.Access/README.md) | `AccessDocument` | |
  100. | OneNote `.one` | [OfficeIMO.OneNote](OfficeIMO.OneNote/README.md) | `OneNoteSection` | `.OneNote.Markdown`, `.OneNote.Html`, `.OneNote.Pdf` |
  101. | Email `.eml`, `.msg`, `.pst` | [OfficeIMO.Email](OfficeIMO.Email/README.md) | | `.Email.Html`, `.Email.Image` |
  102. | RTF | [OfficeIMO.Rtf](OfficeIMO.Rtf/README.md) | `RtfDocument` | `.Rtf.Pdf`, `.Rtf.Markdown` |
  103. | OpenDocument `.odt`, `.ods`, `.odp` | [OfficeIMO.OpenDocument](OfficeIMO.OpenDocument/README.md) | | `.OpenDocument.Odt.Pdf`, `.Ods.Pdf`, `.Odp.Pdf` |
  104. | EPUB | [OfficeIMO.Epub](OfficeIMO.Epub/README.md) | `EpubDocument` | `.Epub.Image` |
  105. | CSV | [OfficeIMO.CSV](OfficeIMO.CSV/README.md) | | `.Excel.Csv` |
  106. | YAML | [OfficeIMO.Yaml](OfficeIMO.Yaml/README.md) | `YamlDocument` | `.Yaml.Configuration` |
  107. | TOML | [OfficeIMO.Toml](OfficeIMO.Toml/README.md) | `TomlDocument` | `.Toml.Configuration` |
  108. | Apple Pages, Numbers, Keynote | [OfficeIMO.IWork](OfficeIMO.IWork/README.md) | | `.Word.IWork`, `.Excel.IWork`, `.PowerPoint.IWork` |
  109. | AsciiDoc, LaTeX | [OfficeIMO.AsciiDoc](OfficeIMO.AsciiDoc/README.md), [OfficeIMO.Latex](OfficeIMO.Latex/README.md) | | `.Markdown`, `.Pdf` |
  110. | Publisher, XPS, DjVu, CHM, DocBook, OPML | [OfficeIMO.Publisher](OfficeIMO.Publisher/README.md), [OfficeIMO.Xps](OfficeIMO.Xps/README.md), [OfficeIMO.DjVu](OfficeIMO.DjVu/README.md), [OfficeIMO.Chm](OfficeIMO.Chm/README.md), [OfficeIMO.DocBook](OfficeIMO.DocBook/README.md), [OfficeIMO.Opml](OfficeIMO.Opml/README.md) | | `.Pdf` where listed |
  111. Shared and cross-format packages:
  112. | Need | Package |
  113. | --- | --- |
  114. | Theme, colors, lengths, charts, drawing and image export used by every format | [OfficeIMO.Core](OfficeIMO.Core/README.md) |
  115. | File-to-file and batch conversion across every registered route | [OfficeIMO](OfficeIMO/README.md) (`OfficeConverter`) |
  116. | Read, search and chunk any format for indexing and AI ingestion | [OfficeIMO.Reader.All](OfficeIMO.Reader.All/README.md), or one `OfficeIMO.Reader.{Format}` |
  117. | OCR for scanned pages and images | [OfficeIMO.Ocr](OfficeIMO.Ocr/README.md), [OfficeIMO.Ocr.Tesseract](OfficeIMO.Ocr.Tesseract/README.md), [OfficeIMO.Pdf.Ocr](OfficeIMO.Pdf.Ocr/README.md) |
  118. | Certificate signatures for Word, PDF and email | [OfficeIMO.Security](OfficeIMO.Security/README.md) |
  119. | Print any convertible document to installed queues or IPP printers on Windows, macOS and Linux, with sheet preview and job tracking | [OfficeIMO.Workflows](OfficeIMO.Workflows/README.md#print-a-document) |
  120. | Snapshot tests for generated PDFs | [OfficeIMO.Pdf.Testing](OfficeIMO.Pdf.Testing/README.md) |
  121. | ZIP, CAB, MSI, TAR and gzip extraction; reproducible ZIP, TAR and gzip creation | [OfficeIMO.Archives](OfficeIMO.Archives/README.md) |
  122. | Google Docs, Sheets, Slides and Drive | [OfficeIMO.GoogleWorkspace](OfficeIMO.GoogleWorkspace/README.md) |
  123. | Confluence pages | [OfficeIMO.Confluence](OfficeIMO.Confluence/README.md) |
  124. | Electronic invoices | [OfficeIMO.Invoicing](OfficeIMO.Invoicing/README.md) |
  125. The [package catalog](Docs/officeimo.package-catalog.md) lists every package, what each one covers and its third-party dependencies. The [generated operation contract](Docs/Compatibility/generated/package-operations.md) shows each package's supported operations.
  126. ## Tools
  127. - [PSWriteOffice](PowerShell/PSWriteOffice/README.MD): PowerShell commands for every format, from `Install-Module PSWriteOffice`.
  128. - [OfficeIMO.Tool](OfficeIMO.Tool/README.md): the `officeimo` command line, from `dotnet tool install --global OfficeIMO.Tool`. It also serves conversions, extraction and search to AI agents over MCP; the [Document Tools plugin](.agents/plugins/officeimo-document-tools/README.md) installs it in Claude Code, Codex, VS Code and Cursor.
  129. - [OfficeIMO Studio](https://officeimo.com/studio/): an app for reading, marking up, filling, converting, protecting and signing documents on Windows and Linux ([README](OfficeIMO.Studio/README.md)), with native Mac, iPad and iPhone apps in development ([README](Apple/OfficeIMOStudio/README.md)).
  130. ## Platforms
  131. Every library targets `netstandard2.0`, `net8.0` and `net10.0`; Windows builds also target `net472`, so .NET Framework applications get the same routes. A few packages that depend on modern-only runtimes, such as `OfficeIMO.Tool`, `OfficeIMO.AI` and `OfficeIMO.Odbc`, target modern .NET only; their READMEs say so.
  132. OfficeIMO runs on Windows, macOS and Linux, in services, containers and build agents. It does not automate Office applications. Word, Excel and PowerPoint use the [Open XML SDK](https://github.com/dotnet/Open-XML-SDK) for package mechanics and HTML uses [AngleSharp](https://github.com/AngleSharp/AngleSharp) for parsing. The PDF, Markdown, RTF, OpenDocument, OneNote, email and other engines are OfficeIMO's own code; the [package catalog](Docs/officeimo.package-catalog.md#dependencies) lists every third-party dependency.
  133. Keep every OfficeIMO package in an application on the same version.
  134. ## Documentation
  135. - [Migration guide](MIGRATION.md): what changed in 3.6 and how to update code and scripts.
  136. - [Documentation index](Docs/README.md): guides, support matrices and evidence.
  137. - [Examples](OfficeIMO.Examples/README.md): runnable examples for every package.
  138. - [API design](Docs/officeimo.api-design.md): the naming, lifecycle and conversion rules every package follows.
  139. - [Roadmap](Docs/ROADMAP.md) and [GitHub Releases](https://github.com/EvotecIT/OfficeIMO/releases).
  140. Report bugs and request features in [OfficeIMO issues](https://github.com/EvotecIT/OfficeIMO/issues), for the libraries and PSWriteOffice alike.
  141. ## Sponsors
  142. If OfficeIMO saves you time, please consider supporting the work through [GitHub Sponsors](https://github.com/sponsors/PrzemyslawKlys) or [PayPal](https://paypal.me/PrzemyslawKlys).
  143. <!-- POWERFORGE:sponsors-readme:START -->
  144. <p>
  145. <a href="https://github.com/KelvinTegelaar" title="KelvinTegelaar"><img src="https://avatars.githubusercontent.com/u/49186168?u=49610dcd84d6c868d9e47c1a64ac137f3da24808&amp;v=4" width="48" height="48" alt="KelvinTegelaar" /></a>
  146. <a href="https://github.com/apbirch67" title="Andrew Birch"><img src="https://avatars.githubusercontent.com/u/12010032?u=79082c6c1f026e3ab39dae7a4aff8e8fadeeeeea&amp;v=4" width="48" height="48" alt="Andrew Birch" /></a>
  147. <a href="https://github.com/thomas-moeller" title="Thomas M&#248;ller"><img src="https://avatars.githubusercontent.com/u/37923349?u=e5b9b9d52dc33256937ace98623e3b7c6aead98a&amp;v=4" width="48" height="48" alt="Thomas M&#248;ller" /></a>
  148. <a href="https://github.com/jakehildreth" title="Jake Hildreth"><img src="https://avatars.githubusercontent.com/u/93942157?u=e1e8d3f460d775c44f5491711ad1c47a5005fb5c&amp;v=4" width="48" height="48" alt="Jake Hildreth" /></a>
  149. <a href="https://github.com/complea" title="Complea"><img src="https://avatars.githubusercontent.com/u/144781871?v=4" width="48" height="48" alt="Complea" /></a>
  150. <a href="https://github.com/DarthPanda12" title="DarthPanda12"><img src="https://avatars.githubusercontent.com/u/294241377?v=4" width="48" height="48" alt="DarthPanda12" /></a>
  151. </p>
  152. [See all sponsors](SPONSORS.md)
  153. <!-- POWERFORGE:sponsors-readme:END -->
  154. ## License
  155. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.