Research

Provides a Research MCP Server that retrieves survey data from Notion and creates survey pages.

python

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-h-yanagawa_research-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "notion-client",
        "--with",
        "pydantic",
        "mcp",
        "run",
        "/path/to/research-mcp-server/server.py"
      ],
      "env": {
        "NOTION_TOKEN": "YOUR_TOKEN",
        "NOTION_ROOT_DATABASE_ID": "YOUR_DATABASE_ID"
      }
    }
  }
}

You can run a dedicated MCP server that plugs into Claude Desktop to retrieve survey data from Notion and create survey pages there. This server is designed to be launched via UVX and integrated into your MCP client for automated survey workflows.

How to use

To use this MCP server, you run it as a local process that your MCP client can communicate with. It starts through a command that loads the necessary MCP components and connects to Notion with your token. Once running, you can instruct Claude to perform surveys and review the results, which will be retrieved from Notion and can be used to populate Notion pages or databases.

How to install

Prerequisites: Python 3.12.1 or later, uv 0.5.25 or later, Claude Desktop Client.

Clone the project files to your local development machine.
Obtain a Notion token from Notion Integrations.
In Notion, create a database page and copy the database ID from the URL. The database ID is the last segment of the page URL.
Create a .env file with your Notion credentials and database ID.

NOTION_TOKEN=[YOUR_NOTION_TOKEN]
NOTION_ROOT_DATABASE_ID=[YOUR_NOTION_DATABASE_ID]

Add an MCP server definition to claude_desktop.json using the provided snippet. The command uses UV to run the server script with the required modules.

{
  ...
  "mcpServers": {
    "Research MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "--with", "mcp[cli]",
        "--with", "notion-client",
        "--with", "pydantic",
        "mcp",
        "run",
        "/path/to/research-mcp-server/server.py"
      ]
    }
  }
}

Additional notes

Restart the Claude Desktop Client to launch the Research MCP Server.
Ask Claude to perform a survey and review the results.

Available tools

retrieve_survey

Retrieves survey data from the configured Notion database so you can review responses and aggregate results.

create_survey_pages

Creates or updates survey pages in Notion based on retrieved data, enabling structured reporting.

Built by

VeilStrat

AI signals for GTM teams