← Back to directory
O

OpenPaean

Community
Not a standard server
Open source AI agent CLI with fullscreen TUI and local MCP integration

This is not a typical connect-and-use MCP server; read the source repository before using it.

Category
Dev Tools #308 of 438
Stars
★ 94 Popular
Transport
stdio (local process)
Runtime
Node.js 18+ · Bun
Credentials
API key / credential required
License
MIT
Last commit
⚠
45FMRS · D

OpenPaean is an emerging open-source AI agent CLI with fullscreen TUI and local MCP integration. It is suitable for terminal users and those needing local tool invocation.

Strongest · Maintenance 11/20 Weakest · Reliability 5/20

Reliability
5/20
Security and permissions
10/20
Maintenance
11/20
Documentation
10/20
Setup experience
9/20
Why each score
Reliability 5/20
The repository root lacks a clear server manifest and test files. The project is a CLI tool rather than a traditional MCP server, and its MCP client functionality depends on an external API, whose details are not visible in the repo. Startup and tool-list handshake are not directly evidenced; error handling and dependency control are only hinted by README options. Happy path may work but lacks reproducible tests or CI, and its viability as an MCP server is uncertain.
Security and permissions 10/20
No red flags: no malware indicators, no hardcoded credentials, and credentials stored in local config directory. Security policy and trusted MCP server warning are present. However, least privilege, data flow disclosure, and confirmation of dangerous operations are incomplete. No network exposure or remote command defaults, so moderate-high score.
Maintenance 11/20
Repository has 95 stars, 6 open issues, not archived. MIT license, security policy and contributing guide referenced in README. However, release cadence, commit frequency, or dependency updates are not directly evidenced, and governance details are incomplete.
Documentation 10/20
README provides installation, login, startup, and MCP server configuration instructions, with CLI options and environment variables. Architecture diagram included. Missing tool parameter details, API rate limits, cost, or troubleshooting specifics. Docs cover usage but with limited depth.
Setup experience 9/20
Install steps are clear, offering curl script, bun, npm, and npx. MCP config file example provided, but client configuration examples are lacking. Requires Node.js 18+ or Bun and a Paean AI account. Overall easy but manual steps involved.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessRuns commands or codeUses the network

Best for

  • Developers who prefer terminal-based workflows
  • Users needing local tool integration with an AI agent

Not for

  • Users requiring a graphical interface
  • Those without Node.js or Bun environment

Required permissions

  • Access to local filesystem (via MCP servers)
  • Read/write to user config directory (~/.openpaean/)

Risks and side effects

  • Configuring untrusted MCP servers may lead to arbitrary code execution
  • Credentials stored locally; protect config files

Setup

Before you start

Runtime:Node.js 18+ · Bun

Other optional settings (2)
OPENPAEAN_API_URL optional Overrides the default API endpoint for self-hosted backends; only needed for self-hosted deployments.
OPENPAEAN_WEB_URL optional Overrides the web URL used for OAuth callbacks; only needed for self-hosted deployments.

Quick install: run curl -fsSL https://paean.ai/openpaean/install.sh | bash, or install globally with a package manager: bun add -g openpaean or npm install -g openpaean, or use directly with npx openpaean.

Check that it works

Run `openpaean login` to authenticate, then start `openpaean`; if the fullscreen TUI opens and streams AI responses, the install works.

Troubleshooting

  1. Ensure Node.js 18+ or Bun is installed
  2. Check network connectivity
  3. Verify MCP server configuration is correct and accessible

Use cases

Interactive AI chat in the terminal
Call tools via local MCP servers
View, create, and manage tasks from the command line

Overview

OpenPaean is a powerful command-line AI agent that provides a fullscreen TUI, interactive agent chat, task management, and local MCP integration for tool calling.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 63.3k · Tools 2 Compare with this →

Source revision 683d462c0d2e Data synced 2026-10-19 Read the FMRS scoring method