AgentHubAgentHub

OfficeAgent.NET MCP Setup & Guide

MCP ServerMCP RegistryOfficial

io.github.ilia-sokolov/officeagent · v1.1.0

Create and edit Word, PowerPoint, and Excel files with typed plans and safe previews

Copy the install config on this page first, then verify docs and permissions upstream.

Overview

Create and edit Word, PowerPoint, and Excel files with typed plans and safe previews OfficeAgent.NET is a MCP Server listed from MCP Registry. Transports: stdio. This page includes an overview, setup tutorial, install commands, and use cases for Trae, Tongyi Lingma, Cursor, Claude Code, and VS Code.

Use cases

AgentHub Verified AvailabilityTested & Ready

Automated pipeline validated install commands, protocol & client compatibility

Verified At2026-10-04
Install Snippets TestedCLI & JSON config syntax verified
Protocol Handshake ReadyComplies with JSON-RPC 2.0 specifications
Origin Registry ActiveSourced from official-mcp-registry
Verified ClientsClaude Code、Claude Desktop、Cursor 等
Security Tier: A+ 级 · 官方认证推荐 (A+)·Maintained by official/verified teams, audited for standard MCP protocol compliance.
No auto-generated install guide — see the source repository README.

Troubleshooting & Common ErrorsFAQ

Common connection errors and verified fixes for OfficeAgent.NET

Getting 'connection closed' or exit code 1 in Cursor / Claude Code for OfficeAgent.NET?

Usually caused by missing runtime paths or IDE environment inheritance. Fix steps: 1. Verify Node.js 18+ (npx) or Python 3.10+ (uvx) is installed; 2. Run 'which npx' or 'which uvx' in terminal, and replace 'command' with absolute path; 3. Reload or restart the client window after modifying config.

Fix Snippet
# Check binary path in terminal:
which npx
node -v
Getting 'spawn npx ENOENT' or 'command not found'?

The editor background process does not inherit your full terminal PATH. Solution: Globally install the package, or set the absolute binary path (e.g. C:\Program Files\nodejs\npx.cmd on Windows, or /usr/local/bin/npx on macOS).

Missing required environment variable or authentication failure?

OfficeAgent.NET requires environment variables (OfficeAgent__FileSystemConnections__0__ConnectionId、OfficeAgent__FileSystemConnections__0__RootPath、OfficeAgent__AllowCreation). Ensure you have added valid keys under the 'env' object in your config file without trailing whitespace.

Fix Snippet
// .cursor/mcp.json 或 claude_desktop_config.json
{
  "env": {
    "API_KEY": "your_actual_key_here"
  }
}

Tool Mock Playground

Sandbox

OfficeAgent.NET Tool Interface Simulation · Preview tool schema & outputs without local runtime

Sandbox Ready
fn: officeagentExecute the core tool interface of OfficeAgent.NET
Request ArgumentsJSON Schema
{
  "target": "OfficeAgent.NET",
  "action": "execute",
  "options": {
    "mode": "standard",
    "timeoutMs": 5000
  }
}
💡Parameters generated dynamically by Agent runtime
Agent Tool Output

Click 'Run Mock' above

to preview the raw response returned to the LLM

Env: AgentHub Virtual SandboxJSON-RPC 2.0

Decision Guide: Why & When to Use

Assess suitability before installing to save trial-and-error time

Best Suited For
  • PR review
  • Changelog generation
  • Cross-repo issue search
When NOT to Use
  • Replacing human security audit
  • Unauthorized repo access
Recommended Workflow Pairing:View Scenario →

OfficeAgent.NET + Scenario Prompt → Complete Agent Automation

MCP hands-on: install to visible results

Follow the full lab (expected UI/output + contrast checks). After installing this item, verify with the tutorial prompts.

Open tutorial →

Related resources

Often paired with

Keep exploring AgentHub

Most people compare similar tools or check scenario guides before installing—start here.

Listing badge: put AgentHub on your site

Copy either snippet into your project homepage, docs, or GitHub README. The badge is a hotlinked SVG — nothing to host — and it links back to this page so visitors can find the install steps.

PreviewListed on AgentHub: OfficeAgent.NET
HTML
<a href="https://myagenthub.cn/p/io.github.ilia-sokolov/officeagent" title="Listed on AgentHub: OfficeAgent.NET" target="_blank" rel="noopener">
  <img src="https://myagenthub.cn/badge/io.github.ilia-sokolov/officeagent?lang=en" alt="Listed on AgentHub: OfficeAgent.NET" height="20" style="border:0"/>
</a>
Markdown (GitHub README)
[![Listed on AgentHub: OfficeAgent.NET](https://myagenthub.cn/badge/io.github.ilia-sokolov/officeagent?lang=en)](https://myagenthub.cn/p/io.github.ilia-sokolov/officeagent)

Badges are generated on the fly from /badge/<package-id>, so name and listing changes propagate automatically. Keep the link target unchanged — it is what counts as the referral.

Unified Manifest

{
  "id": "io.github.ilia-sokolov/officeagent",
  "type": "mcp-server",
  "version": "1.1.0",
  "displayName": "OfficeAgent.NET",
  "description": "Create and edit Word, PowerPoint, and Excel files with typed plans and safe previews",
  "repository": {
    "url": "https://github.com/ilia-sokolov/OfficeAgent.NET",
    "source": "github"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "nuget",
        "identifier": "OfficeAgent.Mcp",
        "version": "1.1.0",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "OfficeAgent__FileSystemConnections__0__ConnectionId",
            "description": "Connection id the agent uses to address documents on the filesystem (any non-empty string). Optional: with nothing configured the server starts with an in-memory session connection whose documents last only while it runs. Set this and RootPath to edit documents on disk instead; SharePoint is OfficeAgent__SharePointConnections__0__*"
          },
          {
            "name": "OfficeAgent__FileSystemConnections__0__RootPath",
            "description": "Absolute path to the directory this filesystem connection may read and write documents under. Only .docx is allowed unless OfficeAgent__FileSystemConnections__0__AllowedExtensions__N adds more (.pptx for decks or .xlsx for workbooks). Deck connections usually want OfficeAgent__FileSystemConnections__0__DefaultChangeMode=Direct because PowerPoint cannot record tracked changes"
          },
          {
            "name": "OfficeAgent__AllowCreation",
            "description": "Set to true to expose create_document, so an agent can author a new file in the connection rather than only editing existing ones. Off by default: creating agent-named files under a connection root is a capability the host should choose deliberately"
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode",
    "trae",
    "cherry-studio",
    "lingma",
    "windsurf",
    "cline",
    "workbuddy"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.ilia-sokolov/officeagent",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.ilia-sokolov%2Fofficeagent/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}