home / mcp / naver mcp server

Naver MCP Server

python MCP NAVER

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "pfldy2850-py-mcp-naver": {
      "command": "fastmcp",
      "args": [
        "install",
        "mcp_naver/server.py",
        "-e",
        "NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID>",
        "-e",
        "NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>"
      ],
      "env": {
        "NAVER_CLIENT_ID": "<YOUR NAVER CLIENT ID>",
        "NAVER_CLIENT_SECRET": "<YOUR NAVER CLIENT SECRET>"
      }
    }
  }
}

You can run and use the Naver MCP Server to access Naver OpenAPI data through a controlled MCP interface. This server exposes a set of tools for searching blogs, news, books, and more, allowing you to build expressive, model-driven integrations with Naver services.

How to use

To use the Naver MCP Server, run it with an MCP client and provide your Naver OpenAPI credentials. Once the server is running, you can invoke its tools to search blogs, news, books, and other Naver resources, or perform enhanced queries like spelling correction and adult-content checks.

How to install

Prerequisites: you need Python and a compatible MCP client/CLI installed. You also must have access credentials for the Naver Open API.

Step 1: Install the MCP server package from PyPI or install from source as described below.

Step 2: Start the MCP server with your credentials.

# Start the server using the MCP CLI with your Naver Open API credentials
fastmcp install mcp_naver/server.py -e NAVER_CLIENT_ID=<YOUR NAVER CLIENT ID> -e NAVER_CLIENT_SECRET=<YOUR NAVER CLIENT SECRET>

Configuration and usage notes

The server requires you to register for a Naver Open API key. Use the Open API access registration flow to obtain NAVER_CLIENT_ID and NAVER_CLIENT_SECRET, then provide them when starting the server.

Supported tools include Blog Search, News Search, Book Search, and more. You can pass queries and options to each tool to tailor results.

Available tools

search_blog

Search blog posts on Naver with configurable display count and start index, optional sort order.

search_news

Search news articles on Naver with display/start controls and sort options.

search_book

Search books on Naver with paging and sort options to refine results.

get_book_adv

Get advanced book information using title or ISBN and related fields.

adult_check

Check whether a given term is considered adult content.

search_encyc

Search encyclopedia entries on Naver.

search_cafe_article

Search cafe articles with paging and sort controls.

search_kin

Search Q&A content on Naver.

search_local

Search local information with paging and sort options.

fix_spelling

Correct spelling errors in a given text.

search_webkr

Search web pages on Naver.

search_image

Search images with filters and paging.

search_shop

Search shopping items with filters, paging, and sort options.

search_doc

Search documents on Naver.