Univer Use

LangGraph-powered agent utilities and tools for Univer spreadsheets. This library provides a ready-to-use graph entrypoint and helper tools to build agents that operate against Univer via Univer-MCP.

Features

• LangGraph graph entrypoint: univer_use/graph.py:build_graph
• Spreadsheet action agent with MCP tools
• Prompt templates packaged with the library

Install

You can install this package using either name (both are the same package):

Option 1: univer-use

• pip: pip install univer-use
• uv: uv add univer-use
• Poetry: poetry add univer-use

Option 2: spreadsheet-use

• pip: pip install spreadsheet-use
• uv: uv add spreadsheet-use
• Poetry: poetry add spreadsheet-use

Note: Both univer-use and spreadsheet-use provide identical functionality. Choose whichever name you prefer.

Requirements

• Python 3.11+
• Credentials via environment or .env (python-dotenv):
  • OPENROUTER_API_KEY – API key for your OpenRouter-compatible provider
  • OPENROUTER_ENDPOINT – Base URL for the provider endpoint
  • UNIVER_API_KEY – Univer API key (if required by your MCP setup)

Quickstart

First, Initialize Univer Instance (refer to Univer-MCP for more details). You can simply use Univer-MCP Playground.

Then, run the minimal example to compile and run the graph once:

import asyncio
# Both imports work the same way:
# from spreadsheet_use import build_graph
from univer_use import build_graph

async def main():
    graph = await build_graph()
    # Provide initial state. At minimum, include a conversation_id.
    messages = [
        {
            "role": "user",
            "content": "Build a modern salary calculator.",
        }
    ]
    state = {
        "messages": messages,
        "conversation_id": "default",
    }
    result = await graph.ainvoke(state)
    print(result)


if __name__ == "__main__":
    from dotenv import load_dotenv
    load_dotenv()
    asyncio.run(main())

For more details, see examples/sheet_edit.

More examples will be added soon.

This uses the graph at univer_use/graph.py:build_graph. Set env vars in .env or your shell before running. See examples/sheet_edit/.env for an example.

Contributing

Refer to CONTRIBUTING.md for more details.

Available Make Commands Run make help to see all available commands for development.

Package Architecture

• univer-use: The main package containing all functionality
• spreadsheet-use: A lightweight alias package that depends on univer-use

License

MIT. See LICENSE.