@justmpm/nlm

MCP Server para interagir com o NotebookLM via CLI. Expoe 3 tools: login, listagem e consulta de notebooks.

Zero dependencia de API -- faz spawn do CLI nlm instalado localmente.

Instalacao

1. Instalar o CLI nlm (requisito)

npm install -g @notebooklm-mcp-cli/nlm

Autentique uma vez:

nlm login

2. Instalar o MCP Server

Via npm (global):

npm install -g @justmpm/nlm

Via npx (sem instalar):

npx @justmpm/nlm

Via pacote local (desenvolvimento):

cd mcps-ai/nlm
npm install
npm run build

Configuracao

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "nlm": {
      "command": "npx",
      "args": ["@justmpm/nlm"]
    }
  }
}

Usando instalacao global (mais rapido, sem download):

{
  "mcpServers": {
    "nlm": {
      "command": "nlm-mcp"
    }
  }
}

OpenCode

Adicione ao opencode.json na secao mcpServers:

{
  "mcpServers": {
    "nlm": {
      "command": "npx",
      "args": ["@justmpm/nlm"]
    }
  }
}

Usando instalacao global:

{
  "mcpServers": {
    "nlm": {
      "command": "nlm-mcp"
    }
  }
}

Tools

nlm_login

Faz login no NotebookLM CLI.

• Quando usar: Sessao expirada, erro 401, unauthorized
• Apos executar: Aguarde ~30 segundos
• Parametros: Nenhum

nlm_list

Lista todos os notebooks disponiveis.

• Quando usar: Antes de consultar, para descobrir IDs
• Retorna: Tabela com ID, titulo e quantidade de fontes
• Parametros: Nenhum

nlm_query

Consulta um notebook com uma pergunta.

• Quando usar: Precisar de informacao sobre um documento/tecnologia
• Retorna: Resposta com fontes citadas
• Parametros:
  • notebookId (string, obrigatorio) -- UUID do notebook
  • question (string, obrigatorio) -- Pergunta em linguagem natural

Exemplos de Uso

Descobrir notebooks

Tool: nlm_list
Args: {}

Consultar sobre Firestore

Tool: nlm_query
Args: {
  "notebookId": "c5e58e83-b49e-402c-80d4-dc53acb5453e",
  "question": "Como usar aggregate queries no Firestore?"
}

Reautenticar

Tool: nlm_login
Args: {}

Desenvolvimento

# Instalar dependencias
npm install

# Build
npm run build

# Build em modo watch
npm run dev

# Rodar testes
npm test

# Testes em modo watch
npm run test:watch

# Rodar localmente
npm start

Stack

| Tecnologia | Uso | |---|---| | TypeScript | Linguagem principal (strict mode) | | @modelcontextprotocol/sdk | MCP Server | | Zod | Validacao de schemas | | Vitest | Testes |

Licenca

MIT - Koda AI Studio