mcp-mindthread

jingbinw/mcp-mindthread

3.2

If you are the rightful owner of mcp-mindthread and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

MindThread MCP Server is a Model Context Protocol server that integrates Notion notes with Claude Desktop, enabling idea capture, note retrieval, and timeline generation.

Tools
3
Resources
0
Prompts
0

MindThread MCP Server

A Model Context Protocol (MCP) server that surfaces your Notion notes to Claude Desktop. It supports capturing ideas, finding related notes, and generating a date-ordered timeline.

Features

FeatureToolDescription
Notion LoaderSync notes directly from your Notion database with full field support (title, description, category, tags, date, status and priority).
Capture ideascaptureSave new ideas to the in-memory store while automatically extracting sentiment and key topics.
Find related thoughtsfind_relatedFinds conceptually similar notes by keyword and context matching.
Timeline reconnecttimelineBuilds a chronological timeline of notes to visualize idea evolution.

Tech Stack

  • Python 3.13, asyncio
  • MCP framework: fastmcp (stdio transport)
  • Notion REST API via httpx
  • Env management via python-dotenv

Project Structure

  • mcp_server.py – MCP server entrypoint and tool registrations
  • notion_loader.py – Async Notion loader; extracts properties and basic page content
  • tools.py – Tool implementations: capture, find_related, timeline
  • store.py – Simple in-memory store
  • requirements.txt – Python dependencies

Setup

  1. Create and activate a virtualenv, then install deps:
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
  1. Create .env in the project root:
NOTION_TOKEN=secret_xxx
NOTION_DATABASE_ID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

If these are missing/invalid, the server falls back to mock notes.

Running

Start the MCP server locally:

python mcp_server.py

You should see logs like:

[mindthread] Starting Python MCP server...
[mindthread] Loaded N notes from Notion

Using with Claude Desktop

  1. Open Claude Desktop → Settings → Developer → Local MCP servers
  2. Edit the config file claude_desktop_config.json using the example below as a reference
{
  "mcpServers": {
    "mindthread": {
      "type": "stdio",
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/mcp_server.py"],
      "workingDirectory": "/path/to/mcp-mindthread",
      "env": {
        "NOTION_TOKEN": "your_notion_token",
        "NOTION_DATABASE_ID": "your_notion_database_id"
      }
    }
  }
}
  1. In a chat, call tools by typing:
  • @mindthread capture text:"Your idea"
  • @mindthread find_related query:"keyword" limit:5
  • @mindthread timeline topic:"Management Automation Framework" max_points:10

Note: Claude Desktop shows connection and tool execution logs. Startup prints appear in your terminal.

Claude Desktop

Notion Data Mapping

The loader pulls:

  • Title (title)
  • Description/body (rich_text + paragraph blocks)
  • Category/Status (select)
  • Tags (multi_select)
  • Priority (number)
  • Date fields (date) – used by the timeline tool

The combined searchable text is stored under text. Individual fields remain on each note (e.g., Date Added, tags).

Troubleshooting

  • Import error: Ensure your editor uses this repo’s venv (e.g., “Python: Select Interpreter”).
  • No results in timeline: Confirm the topic exists in any fields and that a date is set.
  • Notion errors/fallback: Check .env; if loading fails, mock notes are used.