inbox_add · Mcp Obsidian Planner MCP: Risk & Policy

WHAT IT DOES

What inbox_add does on Mcp Obsidian Planner

AI agents use inbox_add to create or update resources in Mcp Obsidian Planner — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Mcp Obsidian Planner environment.

WHY IT NEEDS A POLICY

Why inbox_add needs a policy

This tool creates or modifies data reversibly by adding a new inbox item. It does not retrieve data (Read), execute arbitrary code or commands (Execute), permanently delete data (Destructive), or involve financial transactions (Financial). The impact is localized to a single inbox entry with minimal blast radius if misused by an agent—worst case, unwanted items are added to the inbox and can be manually removed.

From the tool's definition Tool name 'inbox_add' and description 'Add a new item to the inbox with timestamp' indicate creation of new data in the inbox.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

inbox_add Rate-limited

inbox_add stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "inbox_add": {
      "limits": [
        {
          "counter": "inbox_add_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL →

Instant setup, no code required.

PolicyLayer is an MCP gateway: every tool call is checked against your rule before it reaches Mcp Obsidian Planner, so you can run agents against it safely.

FAQ

Questions about inbox_add

What does the inbox_add tool do? +

Add a new item to the inbox with timestamp. It is categorised as a Write tool in the Mcp Obsidian Planner MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on inbox_add? +

Register the Mcp Obsidian Planner MCP server in PolicyLayer and add a rule for inbox_add: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Mcp Obsidian Planner. Nothing to install.

What risk level is inbox_add? +

inbox_add is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit inbox_add? +

Yes. Add a rate_limit block to the inbox_add rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block inbox_add completely? +

Set action: deny in the PolicyLayer policy for inbox_add. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides inbox_add? +

inbox_add is provided by the Mcp Obsidian Planner MCP server (jarero321/mcp-obsidian-planner). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.