ai-armory

🔌 Serving  ·  📬 Google  ·  🍎 Mac  ·  🧩 Writing a tool set  ·  🤝 Contributing

AI Armory is a collection of MCP tool sets: Google Workspace and Mac control today, with GitHub and more planned. Each tool set is a separate module you can load on its own, written in plain Python with no MCP imports. Load the ones you want, then serve them in-process to the Claude Agent SDK or over stdio to any MCP client.

🐍 Plain Python

A tool is an async function plus a JSON Schema. No MCP library in sight.

📦 Only what you use

Each tool set has its own extra, so you install only its dependencies.

🔒 Safe by design

Sends and deletes are flagged for the host to confirm. AI Armory never prompts.

✨ Tool sets

📬 Google Workspace gmail · calendar · chat · docs · sheets · slides · drive across any number of accounts, or all seven as the google group.

🍎 Mac Notifications, apps and links, Apple Shortcuts, the volume and the clipboard on this Mac. Nothing to configure.

⏰ Clock clock: the current date and time, in any IANA time zone.

🧩 Your own Add a module here, or ship one in another package through an entry point.

Related MCP server: Slipway

🧭 How it fits together

flowchart TB
    google["📬 google<br/>gmail · calendar · chat · docs<br/>sheets · slides · drive"]
    mac["🍎 mac"]
    clock["⏰ clock"]
    plugin["🔌 your package<br/>via entry point"]
    registry[["📚 registry · load_many()"]]
    subgraph Adapters["🔀 Adapters"]
        direction LR
        sdk["🐍 claude_sdk.py<br/>create_sdk_server()"]
        stdio["🖥️ stdio.py<br/>ai-armory serve"]
    end
    agent(["🤖 Claude Agent SDK apps"])
    clients(["💬 Claude Desktop · Claude Code<br/>any MCP client"])

    google & mac & clock --> registry
    plugin -.-> registry
    registry --> sdk & stdio
    sdk -->|"in-process"| agent
    stdio -->|"stdio"| clients

    classDef set fill:#e0f2fe,stroke:#0284c7,color:#0c4a6e
    classDef ext fill:#f1f5f9,stroke:#64748b,stroke-dasharray:5 4,color:#0f172a
    classDef core fill:#ede9fe,stroke:#7c3aed,color:#2e1065
    classDef adapter fill:#fff7ed,stroke:#ea580c,color:#7c2d12
    classDef host fill:#ecfdf5,stroke:#059669,color:#064e3b
    class google,mac,clock set
    class plugin ext
    class registry core
    class sdk,stdio adapter
    class agent,clients host
    style Adapters fill:#f8fafc,stroke:#94a3b8,color:#334155

• Tool sets (blue) are plain Python with no MCP imports; the registry loads them by name.

• Adapters turn the same tool sets into an in-process SDK server or a stdio MCP server.

🚀 Quickstart

1. Install — clone, then install everything or just the extras you need:

git clone https://github.com/anilkumarmeena/ai-armory
cd ai-armory
pip install -e ".[all]"

2. Look around — list the tool sets this install can load:

ai-armory list

3. Connect a client — for example, Claude Code serving the clock:

claude mcp add ai-armory -- ai-armory serve --toolsets clock

📦 Install extras

pip install -e ".[all]"       # everything
pip install -e ".[sdk,clock]" # the Agent SDK adapter and the clock tool set
pip install -e ".[google]"    # the Google tool sets (gmail, calendar, chat, docs, sheets, slides, drive)

🧰 Everyday commands

• serve --name <name> sets the server name reported to the client (default ai-armory).

📚 Documentation

🔌 Serving Standalone over stdio, in-process with the Agent SDK, and how confirmation reaches the host.

📬 Google Every Google tool, accounts, the draft-then-confirm flow, and setup.

🍎 Mac The seven Mac tools, what each runs, and macOS permissions.

🧩 Writing a tool set Adding a tool set, plugins from other packages, the code layout and tests.

🔐 Safety at a glance

• Tools that send, delete or otherwise act on the world are declared needs_confirmation=True; the host gates them.

• Google sends and deletes are two tools: draft, then confirm, and a draft can be used once at most.

• Nothing here sends email without a confirmed draft, trashes mail, deletes a document, spreadsheet, deck or row, or changes, shares or deletes a Drive file.

• Tools that return other people's text tell the model not to follow instructions in it.

Details: 🔌 Serving › Confirmation and 📬 Google › Draft, then confirm.

🧪 Development

pip install -e ".[dev]"
pytest

See 🧩 Writing a tool set to add your own.

🤝 Contributing

Issues and pull requests are welcome. 🤝 Contributing covers setup with uv, the checks, code style and what makes a pull request easy to merge.

📄 License

MIT, see LICENSE.

AI Armory · tools for agents, written once