Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NIRVANA_AUTH_TOKENYesNirvana authentication token obtained via the login command

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_inboxA

Returns tasks in the Nirvana Inbox (state=0) — unprocessed items the user hasn't categorized yet.

get_next_actionsA

Returns tasks marked as Next Actions in Nirvana (state=1) — concrete, actionable next steps the user has committed to.

get_waiting_forA

Returns tasks the user is Waiting on someone else for in Nirvana (state=2). Often blocked on a contact's response or delivery.

get_scheduledA

Returns Scheduled tasks in Nirvana (state=3) — tasks deferred to a specific future start date.

get_somedayA

Returns tasks parked in Nirvana's Someday list (state=4) — things to revisit later but not actionable now.

get_logbookA

Returns completed tasks logged in Nirvana (state=7). Use this to review what the user finished.

get_focusA

Returns tasks the user has flagged for Focus in Nirvana (seqt > 0), excluding completed or trashed items. These are what the user is actively prioritizing right now.

list_projectsA

Returns the user's active projects in Nirvana (state=11). Projects are containers that group related tasks under a shared outcome.

get_projectA

Returns a single project and all of its direct child items (tasks and sub-projects). Identify the project by its exact id (UUID) or its exact name. Provide exactly one. Use list_projects first to discover names.

list_areasA

Returns the user's Areas in Nirvana — high-level life domains (e.g. 'work', 'personal') that group projects and tasks. Areas are the top-level organizing dimension.

list_tagsA

Returns the user's labels in Nirvana — plain tags, GTD contexts (e.g. @phone, @home), and contacts (people the user waits on). Each entry has a kind field distinguishing them. For high-level life domains, use list_areas instead.

search_tasksA

Search the user's Nirvana tasks with any combination of filters. At least one filter is required. Trashed and deleted tasks are always excluded. Completed (logged) tasks are excluded unless state: "logged" is passed — pair text search with state="logged" to mine the user's history.

get_laterA

Returns tasks in Nirvana's Later list (state=5) — things the user will definitely do, but not in the immediate Next queue. Sits between Next and Someday.

get_trashA

Returns tasks the user has thrown into Trash (state=6). These are soft-deleted but recoverable — useful for finding something the user trashed but might want back.

get_recurringA

Returns the user's recurring task templates in Nirvana (state=9). These are the rules that spawn task instances on a schedule, not individual occurrences.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Sgoettschkes/nirvana_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server