ironclaw MCP Client

Use This MCP client To

Keep a private, running memory of my notes and conversations Get automatic summaries or reminders sent to me on a schedule Chat with my assistant through Telegram or Slack Have my assistant watch for changes and alert me Build a quick custom tool for a task I repeat often Keep my personal information off of someone else's servers

README

IronClaw

Your secure personal AI assistant, always on your side

English | 简体中文 | Русский | 日本語 | 한국어

Quick Start • Philosophy • Features • Installation • Configuration • Security • Architecture

Quick Start

Choose an ironclaw-v* tag from the Releases page, then install it on macOS, Linux, or Windows/WSL. Replace X.Y.Z with the selected version, including any prerelease suffix:

IRONCLAW_RELEASE_TAG=ironclaw-vX.Y.Z
curl --proto '=https' --tlsv1.2 -LsSf \
  "https://github.com/nearai/ironclaw/releases/download/${IRONCLAW_RELEASE_TAG}/ironclaw-installer.sh" | sh

Then run the guided setup:

ironclaw onboard

Choose an LLM provider, enter its API key in the hidden prompt, and accept the default model or enter another one. IronClaw provisions its local configuration, encrypted credential store, and WebUI login token. On macOS and Linux it also installs and starts the background service, then prints a link that opens the WebUI.

Use ironclaw status to check the service and print the login link again. Windows users can start the WebUI in the foreground with ironclaw serve. See Installation for Windows installers and source builds.

ironclaw FAQ

Can I use this to keep notes and have my assistant remember them later?

Yes — it stores your notes and past conversations so it can recall them whenever you ask.

Can I use this to get updates sent to me automatically?

Yes — you can set up a schedule so it checks on something and messages you, for example every morning.

Which apps can I talk to it through?

You can use it through a web browser, or connect it to Telegram or Slack; it is not an add-on for an existing app like Gmail or a code editor.

Do I need an API key or account?

Yes — you'll need to sign up with an AI provider such as OpenAI, Claude, or Gemini and enter an API key during setup.

How hard is it to set up?

It takes some comfort with the command line — you run an install script and a short setup wizard, so it works best for someone willing to follow technical steps or get help from someone who is.

Is my information private?

Yes — everything is stored and encrypted on your own computer instead of being sent to a company's servers.

Can it look at files or notes on my computer?

Yes — you can point it at files and notes, and it will fold them into what it remembers.

Does it work on Windows, Mac, or Linux?

Yes — it installs on macOS, Linux, and Windows, including through WSL.