# Oleafly

> Oleafly is an open-source MCP server for files and documents. MCP server letting Claude, Codex or Cursor read, edit and compile the open Oleafly project. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Website:** https://oleafly.com/docs/mcp/
- **Repository:** https://github.com/oleafly/oleafly
- **MCP Registry name:** io.github.Oleafly/oleafly
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/oleafly
