home / mcp / learnmcp server

LearnMCP Server

Standalone MCP server that extracts and summarizes learning content, then provides summaries to Forest for enhanced task generation.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "bretmeraki-learnmcp": {
      "command": "node",
      "args": [
        "server.js"
      ],
      "env": {
        "FOREST_DATA_DIR": "<same as Forest>"
      }
    }
  }
}

LearnMCP Server is a standalone MCP server that extracts and summarizes learning content from diverse sources and makes those summaries available to Forest for smarter task generation. It operates independently or alongside Forest, processing YouTube transcripts, PDFs, and web articles to produce concise, relevant summaries you can reuse in your workflows.

How to use

You interact with LearnMCP through an MCP client. Add learning sources to a project, trigger background processing, and then retrieve summaries. When Forest is active, processed summaries can optionally be included in Forest’s HTA task prompts to inform generation with contextual learning content.

Basic workflow to leverage LearnMCP within a project:

1) Add sources to a project using the LearnMCP client: add_learning_sources with a project_id and a list of URLs.
2) Start background processing of pending sources using process_learning_sources for the same project.
3) Monitor progress with get_processing_status for the project.
4) Retrieve a summarized view of the learning content with get_learning_summary for the project (or a specific source_id).

How to install

Prerequisites: ensure Node.js and npm are installed on your system.

Navigate to the LearnMCP server directory you already have in your environment.

# Install dependencies for the LearnMCP server
cd learn-mcp-server
npm install
```

```
# Configure MCP to include LearnMCP as an MCP server
```

```json
{
  "mcpServers": {
    "learn_mcp": {
      "command": "node",
      "args": ["server.js"],
      "cwd": "learn-mcp-server",
      "env": {
        "FOREST_DATA_DIR": "<same as Forest>"
      }
    }
  }
}
```

```
# Start behavior
```
The LearnMCP server starts automatically when your MCP config is loaded by the client (no separate start command required in this flow).

Configuration and notes

Environment variables you need to provide or mirror from Forest:

FOREST_DATA_DIR: Shared data directory with Forest (required). Use the same path Forest uses for data storage.

Available tools

add_learning_sources

Add learning sources (URLs) to a project for content extraction.

process_learning_sources

Start background processing of pending learning sources.

list_learning_sources

List learning sources for a project, optionally filtered by status.

get_learning_summary

Get learning content summary for a project or a specific source.

delete_learning_sources

Delete learning sources and their summaries.

get_processing_status

Get current processing status for learning sources.