Office Word MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Criar .docx do zero com estilos e títulos adequados
Ler documentos existentes em contorno estruturado
Adicionar/modificar tabelas com controle no nível de célula
Buscar e substituir em todo o documento
Inserir imagens e aplicar alinhamento/dimensionamento

Demo ao vivo

Como fica na prática

office-word-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "office-word-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "office-word-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "office-word-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "office-word-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "office-word-mcp",
      "command": "uvx",
      "args": [
        "--from",
        "office-word-mcp-server",
        "word_mcp_server"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "office-word-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "--from",
          "office-word-mcp-server",
          "word_mcp_server"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add office-word-mcp -- uvx --from office-word-mcp-server word_mcp_server

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Office Word MCP

Gerar relatórios de status semanais como documentos Word polidos

👤 PMs, analistas, consultores que entregam em .docx ⏱ ~25 min beginner

Quando usar: Seu cliente espera Word, não Markdown ou PDF, e você não quer copiar e colar toda semana.

Pré-requisitos

Documento template para copiar o estilo — Salve seu relatório padrão como ~/templates/status-report.docx

Fluxo

Abrir o template

Use word-mcp. Open ~/templates/status-report.docx and tell me its structure (headings + table count).✓ Copiado

→ Contorno retornado — lista de H1, H2, dimensões de tabelas
Preencher com os dados desta semana

Save a copy as week-of-2026-04-27.docx. Replace placeholder tables with this week's numbers (paste data). Leave the cover page intact.✓ Copiado

→ Cópia salva, tabelas atualizadas, capa intacta
Adicionar um parágrafo de resumo

Under 'Executive Summary', insert 3 paragraphs covering top wins, blockers, and asks. Match the existing paragraph style.✓ Copiado

→ Parágrafos adicionados com estilo correto

Resultado: Um relatório Word pronto para entrega regenerado semanalmente sem formatação manual.

Armadilhas

Fontes customizadas do template não incorporadas — O python-docx escreve referências; se o destinatário não tiver as fontes, incorpore via interface do Word ou use fontes do sistema

Combine com: filesystem

Revisar um rascunho de contrato com comentários

👤 Funções adjacentes ao jurídico revisando rascunhos de terceiros ⏱ ~30 min intermediate

Quando usar: Você recebe um rascunho de contrato e quer que o Claude sinalize cláusulas arriscadas com comentários ancorados.

Fluxo

Ingerir o documento

Read contract.docx. List the section headings and any clauses with payment terms or liability caps.✓ Copiado

→ Índice de seções mais cláusulas destacadas
Adicionar comentários nos pontos de risco

For each risky clause, add a comment from 'Claude' explaining the concern and a suggested redline.✓ Copiado

→ Comentários visíveis ao abrir no Word

Resultado: Rascunho marcado pronto para encaminhar ao advogado.

Armadilhas

Ancoragem deriva em parágrafos longos — Ancore por frase, não por parágrafo; verifique reabrindo no Word

Estilo mala direta: gerar 50 cartas personalizadas a partir de um CSV

👤 Ops/RH/admin enviando comunicações personalizadas ⏱ ~20 min beginner

Quando usar: Você tem uma lista de destinatários e uma carta template; quer um .docx por pessoa.

Pré-requisitos

Lista de destinatários como CSV — Colunas: name, email, custom_field

Fluxo

Mapear os campos

Open template.docx. Show me every {{placeholder}} and ask which CSV column maps to each.✓ Copiado

→ Lista de placeholders, prompt de mapeamento
Executar a mesclagem

For each row in recipients.csv, render template.docx into ./output/<lastname>.docx. Confirm count at the end.✓ Copiado

→ N arquivos gravados; relatório confirma correspondência entre linhas e arquivos

Resultado: Arquivos .docx por destinatário prontos para anexar ao email.

Armadilhas

Caracteres especiais em nomes quebram os nomes de arquivo — Faça slugify antes de salvar

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

office-word-mcp + office-powerpoint-mcp

Gerar um relatório Word e um deck de slides correspondente a partir de uma mesma fonte

Take the same data — produce status.docx for the long form and status.pptx for the readout.✓ Copiado

office-word-mcp + filesystem

Ler entrada CSV e depois gravar saídas .docx por linha

Read recipients.csv via filesystem; render template.docx per row via word-mcp.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
create_document	filename, title?, author?	Iniciar um novo documento
get_document_text	filename	Ler conteúdo existente
add_paragraph	filename, text, style?	Adicionar texto ao corpo
add_heading	filename, text, level	Estrutura de seções
add_table	filename, rows, cols, data?	Conteúdo tabular
search_and_replace	filename, find, replace	Mudanças de texto em massa / preenchimento de template
add_comment	filename, paragraph_index, text, author	Revisão de contratos (redlining)

Custo e limites

O que custa rodar

Cota de API: N/A — local
Tokens por chamada: 100–500 por chamada
Monetário: Gratuito (MIT)
Dica: Use search_and_replace em vez de reescrever o documento inteiro em streaming

Segurança

Permissões, segredos, alcance

Escopos mínimos: filesystem-read filesystem-write

Armazenamento de credenciais: Nenhum

Saída de dados: Nenhum

Tenha cuidado ao passar documentos jurídicos privados por qualquer sessão de LLM

Solução de problemas

Erros comuns e correções

PermissionError ao salvar

O arquivo está aberto no Word — feche-o antes de deixar o Claude gravar

Estilo não aplicado

Os nomes de estilo são case-sensitive no python-docx; verifique os nomes de estilo no template original

Comentários não aparecem

Certifique-se de que o Word abre com o painel de comentários visível; os comentários são salvos corretamente no XML do .docx

Alternativas

Office Word MCP vs. outros

Alternativa	Quando usar	Troca
Office PowerPoint MCP	Você precisa de slides, não de documentos	Superfície diferente, do mesmo autor
Excel MCP Server	Você precisa de planilhas	Excel é para dados tabulares; Word é para prosa

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills