Skip to main content
Glama

datajud-mcp

Conector MCP de exemplo que deixa o Claude consultar processos judiciais na API Pública do DataJud, do Conselho Nacional de Justiça.

Feito para a aula 8 do curso de Claude Code para Defensores (ANADEF, novembro de 2026), para mostrar, num projeto pequeno, o caminho inteiro:

  1. o CNJ oferece uma API (um balcão onde um programa pede e outro responde);

  2. este projeto transforma esse balcão num conector MCP (a tomada padrão que o Claude sabe usar);

  3. o conector fica no GitHub, e qualquer pessoa o instala pedindo ao Claude.

O que ele faz

Uma ferramenta só, consultar_processo: recebe o número do processo no padrão do CNJ, descobre o tribunal pelo próprio número e devolve os dados de capa (classe, assuntos, órgão julgador, grau, datas) e os últimos andamentos.

Atende a Justiça Federal (TRF1 a TRF6), a Estadual (todos os TJs) e a do Trabalho.

Related MCP server: mcp-juridico-brasil

O que ele não faz

  • Não entra em sistema nenhum com login e não pede senha.

  • Não lê documento do processo: só os metadados que o CNJ já publica.

  • Não grava nada.

Os dados vêm do DataJud, que pode estar alguns dias atrás do sistema do tribunal. Para qualquer uso em peça, confira no sistema do tribunal.

A chave

A API Pública do DataJud pede uma chave, mas a chave é pública: o próprio CNJ a divulga na documentação da API. Ela já vem no programa. Se o CNJ trocar a chave, defina a variável de ambiente DATAJUD_CHAVE com a nova.

Chaves que não são públicas nunca devem ir para o GitHub.

Como instalar

Abra o Claude na pasta onde quer o conector e peça:

Quero instalar o projeto https://github.com/jppicanco/datajud-mcp nesta pasta. Antes de instalar, leia o README e o server.py e me diga em português simples o que ele faz, o que acessa e se manda algum dado meu para fora. Depois instale, cadastre o conector no .mcp.json desta pasta e teste.

Depois, abra uma conversa nova (configuração nova só vale em conversa nova) e pergunte, por exemplo: qual é a classe e quais são os últimos andamentos do processo 5027836-02.2024.4.04.7200?

Se preferir fazer à mão

Precisa do Python 3.10 ou mais novo.

git clone https://github.com/jppicanco/datajud-mcp
pip install -r datajud-mcp/requirements.txt

E no .mcp.json da pasta onde você usa o Claude (no Windows, troque python por py e acrescente "-3" antes do caminho):

{
  "mcpServers": {
    "datajud": {
      "type": "stdio",
      "command": "python",
      "args": ["caminho/para/datajud-mcp/server.py"]
    }
  }
}

Licença

MIT. Use, copie e adapte à vontade.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables interaction with the Argentine judiciary system (SAC - Justicia Cordoba) via Claude Desktop, supporting case searches, notifications, and procedural deadlines.
      12
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Connects AI assistants to Brazilian judicial data from DataJud CNJ and 91 courts, enabling process consultation, monitoring, and deadline calculation under the Civil Procedure Code.
      9
      178 PyPI
      141
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables querying public Brazilian court proceedings metadata and movements via the CNJ/DataJud API, covering multiple courts.
      4
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables querying Brazilian judicial case data through CNJ public APIs: fetching case metadata and movements via DataJud, searching publications and intimations from the national electronic justice gazette (DJEN) by case number or OAB, and downloading publication certificates as PDFs.
      -