Skip to content
MCP server

Oleafly

MCP server letting Claude, Codex or Cursor read, edit and compile the open Oleafly project

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally
Version
0.4.8
Listing updated
2 days ago

About Oleafly

Oleafly is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Oleafly is a collaborative editor for LaTeX, Typst and Markdown research writing, and this server lets an outside AI client work on the project that is open in it. The client supplies the model, so no AI provider key is needed inside Oleafly. That suits people who already pay for a Claude or similar subscription and want that chat app to drive their paper.

The server is switched on under Settings, Integrations, Oleafly MCP. It listens only on 127.0.0.1, preferring port 5323, and runs only while Oleafly is open. Clients authenticate with a bearer token shown in Settings. The oleafly command also has a stdio server that finds the running app and token by itself, and each release includes an oleafly.mcpb extension for Claude Desktop.

Config snippets are given for Claude Code, Claude Desktop, Cursor, VS Code, Grok CLI and Codex. The app itself is free and open source, with compilers such as Tectonic, Typst and Pandoc built in, and AI changes arrive as diffs you can review and undo.

Install

Run in a terminal

claude mcp add oleafly -- npx -y https://github.com/Oleafly/Oleafly/releases/download/v0.4.8/oleafly.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "oleafly": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Oleafly/Oleafly/releases/download/v0.4.8/oleafly.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "oleafly": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Oleafly/Oleafly/releases/download/v0.4.8/oleafly.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "oleafly": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Oleafly/Oleafly/releases/download/v0.4.8/oleafly.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "oleafly": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Oleafly/Oleafly/releases/download/v0.4.8/oleafly.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "oleafly": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Oleafly/Oleafly/releases/download/v0.4.8/oleafly.mcpb"
      ]
    }
  }
}

What it does

Project read and edit
Clients can read and change files in the open project.
Search and compile
Search the project and trigger LaTeX, Typst or Markdown builds.
Local-only server
Listens on 127.0.0.1 with a bearer token and runs only while the app is open.
Claude Desktop extension
The oleafly.mcpb bundle skips the config file and token.
Built-in CLI bridge
The oleafly command runs a stdio server that locates the app automatically.
Bring your own model
The client supplies the model, so Oleafly needs no provider key.

Good for

  • Have Claude Code revise a LaTeX paper section
  • Compile a Typst project from an MCP client
  • Search a thesis project through Cursor or Codex
  • Use an existing chat subscription instead of an API key

Pricing

Open source

Free and open source per the README

Prices change. Check oleafly.com before you buy.

Oleafly FAQ

Do I need an AI key in Oleafly?

No. The connected client supplies the model.

Is the server reachable from my network?

No. It listens on 127.0.0.1 only.

Does it keep running when I close the project window?

Yes. It stops only when you turn MCP off or quit Oleafly.

Which clients are documented?

Claude Code, Claude Desktop, Cursor, VS Code, Grok CLI, Codex CLI and Gemini through the oleafly command.

Is Oleafly free?

Yes. Oleafly is open source, so you can use and self-host it for free.

How do I add Oleafly to Claude Code?

Run this command in your terminal: claude mcp add oleafly -- npx -y https://github.com/Oleafly/Oleafly/releases/download/v0.4.8/oleafly.mcpb

What are the best alternatives to Oleafly?

The closest alternatives to Oleafly are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Oleafly

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools