Local Logs MCP Server

MCP for monitoring local application logs with real-time tailing, error tracking, and log search capabilities.

Local serverstdioGo

What is the Local Logs MCP server?

Local Logs MCP server exists for a simple reason — assistants are far more useful when they can act on Local Logs directly instead of describing what you should do. MCP for monitoring local application logs with real-time tailing, error tracking, and log search capabilities.

What the assistant can call

Once Local Logs is connected, these are the calls the assistant has available:

  • get_log_files — List available log files with metadata
  • tail_log — Get last N lines from a log file
  • get_errors — Get recent error log entries
  • get_server_status — Server status summary from logs
  • watch_log — Monitor log file for changes
  • search_logs — Search for text in log files

Configuration and credentials

You will need 2 environment variables: LOGS_DIR, LOG_EXTENSIONS. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Setting it up

Usage on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

Choosing this one

Plenty of monitoring and observability servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Local Logs's toolset — get_log_files, tail_log, get_errors and 3 more — is a fair guide to whether it matches your workflow.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the local logs mcp server does with a few real requests.

Available tools

ToolWhat it does
get_log_filesList available log files with metadata
tail_logGet last N lines from a log file
get_errorsGet recent error log entries
get_server_statusServer status summary from logs
watch_logMonitor log file for changes
search_logsSearch for text in log files

How to install the Local Logs MCP server

{
  "mcpServers": {
    "local-logs": {
      "command": "npx",
      "args": ["-y", "local-logs-mcp-server"],
      "env": {
        "LOGS_DIR": "./logs"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
LOGS_DIRFilesystem location the server is allowed to use.Optional
LOG_EXTENSIONSConfiguration value read at startup.Optional

Example prompts to try

  • Use Local Logs to get log files.
  • Use Local Logs to tail log.
  • Use Local Logs to get errors.

Frequently asked questions

It connects Local Logs to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (get_log_files, tail_log, get_errors, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Local Logs directly.