MCP User Guide
The MCP (Model Context Protocol) is a standard way to give tools for LLMs. Newelle supports both HTTP streamable MCP servers and stdio (local command) MCP servers.
Adding a MCP server
You can easily add a MCP server by opening the settings, going in the "Tools" page and adding the server at the bottom.
After that, the server and its tools will be added.
stdio MCP servers
stdio servers are launched as a local command (for example npx -y @modelcontextprotocol/server-filesystem ~/Documents, or python -m my_mcp_server). Set the server type to Stdio, then fill in the Command, Arguments and optional Environment Variables.
When Newelle runs as a Flatpak, the command is executed on the host system through flatpak-spawn, so npx, node, python, etc. resolve against your machine just like outside the sandbox. No extra setup is needed — the host connection is already permitted.
If you prefer to run a stdio server as HTTP instead, you can bridge it following this guide.