Research MCP Server

Catalog onlyCatalog onlySTDIO

Overview

Research MCP Server is a repository for a research project that functions as an MCP server, allowing users to retrieve and create survey data in Notion.

To use the Research MCP Server, clone the repository, set up your Notion token and database, and configure the server definition in the Claude Desktop Client.

Functions as an MCP server. - Retrieves survey data from Notion. - Creates survey pages in Notion.

Conducting surveys and collecting data through Notion.
Automating survey data retrieval for research purposes.
Integrating survey functionalities within the Notion platform.

Add to your AI client

Use these steps to connect Research MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "research-mcp-server-h-yanagawa": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-research-mcp-server-h-yanagawa"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "research-mcp-server-h-yanagawa": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-research-mcp-server-h-yanagawa"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "research-mcp-server-h-yanagawa": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-research-mcp-server-h-yanagawa"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "research-mcp-server-h-yanagawa": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-research-mcp-server-h-yanagawa"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "research-mcp-server-h-yanagawa": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-research-mcp-server-h-yanagawa"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "research-mcp-server-h-yanagawa": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-research-mcp-server-h-yanagawa"
      ]
    }
  }
}

FAQ

What are the prerequisites for using the Research MCP Server?

You need Python 3.12.1 or later, uv 0.5.25 or later, and the Claude Desktop Client.

Is there a specific Notion setup required?

Yes, you need to create a Notion database and obtain a Notion token for integration.

Can I customize the survey pages?

Yes, you can create and customize survey pages directly in Notion.

Research and data