Oleafly
MCP server letting Claude, Codex or Cursor read, edit and compile the open Oleafly project
- 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.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"oleafly": {
"command": "npx",
"args": [
"-y",
"https://github.com/Oleafly/Oleafly/releases/download/v0.4.8/oleafly.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"oleafly": {
"command": "npx",
"args": [
"-y",
"https://github.com/Oleafly/Oleafly/releases/download/v0.4.8/oleafly.mcpb"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools