PlugWiki
axiom logo

Axiom MCP Server by Charles Wiltgen: Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpmaxiom-mcpcharleswiltgen/axiom

Gives Claude, Cursor or another coding assistant Axiom's Apple-platform guides, and tools to read crash files, simulator logs and performance traces.

This is a community server from Charles Wiltgen, the author of the Axiom skills project. Apple did not make it. It runs on your computer with npx and needs no account or key.

Four tools look up Axiom's skills and agents and work on any computer. The other 15 run bundled Mac programs for logs, crash files and profiling. They need an Apple Silicon Mac with Xcode, and on other systems they return a message instead of running. If you use Claude Code or the Claude app, the Axiom plugin loads the same skills directly; the README says the plugin does not start this server.

Good for

  • iOS and macOS developers who want the assistant to follow Swift 6 and SwiftUI best practice
  • Developers debugging crashes with dSYM files and Xcode crash logs
  • Teams that want to compare performance traces before and after a change

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install axiom MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the axiom MCP server to Claude Code. Run this command:
    
    claude mcp add axiom -- npx -y axiom-mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js (npx).

Skill and agent lookup works on any system. The xclog, xcsym and xcprof tools need an Apple Silicon Mac with Xcode installed.

From the project README. Source.

Tools

  • Lists the Axiom skills by category

    Shows every Axiom skill grouped by category, such as UI and Design. You can narrow it to one category or ask for a one-line blurb per skill. It is the starting point for finding what exists.

    Try: “Show me the Axiom skill catalog for concurrency.”

    Read · axiom_get_catalog

  • Searches skills by keyword

    Ranks skills against your keywords and shows the matching section names. You can filter by skill type, category or source and cap the number of results (default 10).

    Try: “Search the Axiom skills for "swift 6 data race".”

    Read · axiom_search_skills

  • Reads a skill, or just parts of it

    Returns the text of up to 10 skills per call. For a large skill it sends the section list first, so the assistant can ask for only the sections it needs, or force the whole text.

    Try: “Read the navigation section of axiom-swiftui.”

    Read · axiom_read_skill

  • Fetches an agent's instructions

    Returns the full instructions for one Axiom agent, such as build-fixer or accessibility-auditor. The assistant then follows them itself; the server does not run the agent.

    Try: “Get the build-fixer agent and follow it for my failing build.”

    Read · axiom_get_agent

  • Launches a simulator app and records its console

    Starts an app in the iOS Simulator by bundle id and captures everything it prints or logs, as JSON. It stops after the time or line limit you set. Per the README it ends and relaunches the app if it is already running, and it can also save the capture to a file.

    Try: “Launch com.example.MyApp in the simulator and capture 30 seconds of logs.”

    Runs code · axiom_xclog_launch

  • Reads logs from a running simulator app

    Attaches to a simulator process by name or pid and collects its os_log, NSLog and Logger output as JSON. It does not see print or debugPrint output. A time or line limit ends it.

    Try: “Attach to MyApp and show me the Logger output for one minute.”

    Read · axiom_xclog_attach

  • Shows recent logs after a crash

    Pulls recent logs for a process from the simulator or a connected device, going back 5 minutes by default. It reads only.

    Try: “Show the last 10 minutes of logs for MyApp from my iPhone.”

    Read · axiom_xclog_show

  • Lists apps installed on a simulator

    Returns the apps installed on a simulator as JSON, so you can find the bundle id to use with the launch tool.

    Try: “List the apps installed on the booted simulator.”

    Read · axiom_xclog_list

  • Turns a crash file into a readable report

    Reads a crash file (.ips, MetricKit JSON, old .crash or .xccrashpoint), finds the matching debug symbols, translates addresses into function names and guesses the cause. A cache of symbol locations is kept between runs unless you turn it off.

    Try: “Symbolicate ~/Downloads/MyApp-2026-10-30.ips and tell me the cause.”

    Runs code · axiom_xcsym_crash

  • Checks debug symbols match a crash

    Compares the debug symbol files it can find against each library in a crash file by ID and chip type. Use it when a crash report stays unreadable.

    Try: “Check whether my dSYMs match this crash file.”

    Runs code · axiom_xcsym_verify

  • Looks up addresses in a symbol file

    Turns one or more memory addresses into function names using a given dSYM and load address.

    Try: “Resolve 0x100abc000 against MyApp.dSYM with load address 0x100a00000.”

    Runs code · axiom_xcsym_resolve

  • Finds a dSYM by its ID

    Searches the cache, Xcode folders and Spotlight for the debug symbol file with a given UUID.

    Try: “Find the dSYM with UUID 4C2B7F10-0000-0000-0000-000000000000.”

    Files · axiom_xcsym_find_dsym

Read from the source code

Permissions

high risk · 4 things to watch

High risk

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Profiling can start any command you name

    axiom_xcprof_record launches a command you name when the call sets allowLaunch to true, and the assistant chooses that value. System-wide capture works the same way through allowAllProcesses. Approve each call by hand and read the command first. github.com

  • It can restart your simulator app

    axiom_xclog_launch ends and relaunches the app in the simulator, so unsaved state in that app is lost. github.com

  • It writes files to your disk

    Recording saves a .trace file, and the log capture and anonymize tools can save output to a path you give. The crash tool keeps a cache of symbol locations unless the call turns it off. github.com

  • It scans folders for debug symbols

    The crash tools search Archives, DerivedData, Downloads and Spotlight for dSYM files. Keep unrelated sensitive builds out of those folders. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks toNone documented. Skills are bundled in the package.
Sign-in and keysNo credentials are used.
Scopes
  • None. No account or API key.

Questions

Is the Axiom MCP server official?

No. Charles Wiltgen makes the Axiom skills project and this server, and Apple is not involved. This page covers the axiom-mcp package from the CharlesWiltgen/Axiom repo.

Do I need a Mac?

Only for 15 of the 19 tools. The skill lookup tools work anywhere, but the log, crash and profiling tools need an Apple Silicon Mac with Xcode and return a message elsewhere.

Do I need an API key?

No. It runs locally and uses no account or key. It reads Xcode's bundled documentation at startup when Xcode is installed.

Should I use the Axiom plugin or this MCP server?

In Claude Code or the Claude app, the plugin is the main route. The README says the plugin does not start this server, so add the server too if you want the crash, log and profiling tools there. Other tools such as Cursor, VS Code or Gemini CLI can use the server.

Can I run it read-only?

No. The README documents no read-only switch. You can approve each tool call by hand, and profiling a launched command or the whole system stays blocked unless the call asks for it.

Does it run locally?

Yes. It runs on your computer over stdio from the npm package, with the skills bundled inside.

Is it free?

Yes. The package is MIT licensed and needs no paid plan or key.

Information

updated Nov 2, 2026

Publisher
Community
Package
axiom-mcp
Registry
npm
Transport
stdio
Auth
None
Version
27.7.2
License
MIT
Last commit
Oct 31, 2026
Open issues
0

WebsiteGitHubnpmChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 6
  1. README.md · github.com
  2. handler.ts · github.com
  3. xclog.ts · github.com
  4. xcsym.ts · github.com
  5. xcprof.ts · github.com
  6. axiom-mcp · npmjs.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.